{ "openapi": "3.0.1", "info": { "title": "Yahoo! Real Estate Japan Used Condo Prices by Area", "description": "Enter a Japanese city or ward code and see what sellers ask for used condos on Yahoo! Real Estate. You get the average price for each floor plan, how many are already rented to a tenant, building age, walk time to the station, plus nearby areas. $0.02 per area, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "0p45jxVSB8Ou2azZX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~yahoo-realestate-condo-market-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-yahoo-realestate-condo-market-checker", "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/jpmarketdata~yahoo-realestate-condo-market-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-yahoo-realestate-condo-market-checker", "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/jpmarketdata~yahoo-realestate-condo-market-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-yahoo-realestate-condo-market-checker", "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", "required": [ "cityCodes" ], "properties": { "cityCodes": { "title": "Japanese city or ward codes", "type": "array", "description": "5-digit Japanese city codes. 13113 = Shibuya (Tokyo), 27127 = Kita (Osaka), 13205 = Ome (Tokyo). You get one summary row per code, and each code is charged $0.02; a code with nothing for sale is never charged. Up to 10 codes per run. Maximum cost per run is $3.00 by default, far more than 10 areas cost, so what limits a run is time rather than money.", "default": [ "13113" ], "items": { "type": "string" } }, "extraPages": { "title": "Extra sample pages per area", "minimum": 0, "maximum": 4, "type": "integer", "description": "How many more result pages are added to the price sample for each area (one page holds 30 buildings). It only widens that sample — units found, the average for each floor plan, the rented-out share, the age and walk-time tables and the nearby areas all come from the first page and never change. A run stops after 12 page reads, so in a 10-area run the later areas get the first page only.", "default": 1 }, "includeIndividualListings": { "title": "Include individual condo units", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per area. Turn it on to also get one row per condo unit that was read — building name, address, year built, line, station and walk time, floor, direction, size in m2, floor plan, asking price, price per m2, whether it is rented out, whether the price was reduced — at +$0.002 per row. A busy ward returns 60 to 120 rows per area.", "default": false }, "includeNearbyAreas": { "title": "Include nearby areas", "type": "boolean", "description": "On by default. Adds the neighbouring wards to each summary row — their average used-condo price and how many units are on their market — taken from a table the area page already carries. It costs no extra page read and no extra charge. Turn it off if you only want the one area you asked for.", "default": true }, "convertToUsd": { "title": "Convert prices to USD", "type": "boolean", "description": "Adds USD figures next to the yen ones at the current exchange rate (open.er-api.com). A failed rate lookup never fails the run — the yen numbers simply come back on their own.", "default": true } } }, "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 } } } } } } } } } }