{ "openapi": "3.0.1", "info": { "title": "Japan Address Normalizer, Geocoder & Romanizer", "description": "Japanese address geocoding, normalization and romaji conversion. Parses prefecture, city, town, chome and banchi, then returns the JIS municipality code, postal code, latitude/longitude and the English mailing address. 99.33% measured accuracy, from government open data.", "version": "0.1", "x-build-id": "idOvb075qgSlZZ1uQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jp-data-engine~japan-address-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jp-data-engine-japan-address-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jp-data-engine~japan-address-intelligence/runs": { "post": { "operationId": "runs-sync-jp-data-engine-japan-address-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jp-data-engine~japan-address-intelligence/run-sync": { "post": { "operationId": "run-sync-jp-data-engine-japan-address-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "addresses": { "title": "Japanese addresses", "type": "array", "description": "Free-form Japanese addresses, one per line. Full-width digits, kanji numerals (一丁目), 番地/番/号 counters, missing prefectures and trailing building names are all handled. A leading 〒postal code is used as a hint.", "default": [ "東京都渋谷区神宮前１丁目１−１ 原宿ビル３Ｆ", "〒530-0001 大阪府大阪市北区梅田三丁目1番3号", "北海道札幌市中央区北一条西2丁目", "福岡市博多区博多駅前2-1-1", "沖縄県那覇市おもろまち1-1-1" ], "items": { "type": "string" } }, "postalCodes": { "title": "Postal codes to look up", "type": "array", "description": "7-digit Japanese postal codes, with or without the hyphen (`150-0001` or `1500001`). Each one returns every town the registry files under it.", "default": [ "150-0001" ], "items": { "type": "string" } }, "coordinates": { "title": "Coordinates to reverse geocode", "type": "array", "description": "Latitude/longitude pairs inside Japan, e.g. `[{\"latitude\": 35.6595, \"longitude\": 139.7005}]`. Each one returns the nearest 町丁目 and the distance to its centroid.", "default": [ { "latitude": 35.6595, "longitude": 139.7005 } ] }, "includeUnmatched": { "title": "Include unmatched inputs in the output", "type": "boolean", "description": "Keep a row for every input, even the ones that could not be matched to the registry, so the output lines up with the input. Turn off to get matched rows only.", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Hard cap on the number of rows written. This is what determines the cost of the run.", "default": 10000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }