{ "openapi": "3.0.1", "info": { "title": "Japan Used Cars (carsensor.net)", "description": "Japanese used-car listings from carsensor.net — price, year, mileage, repair history, inspection and dealer info by maker/prefecture, English schema. Unofficial; not affiliated with Recruit Co., Ltd.", "version": "0.1", "x-build-id": "HdbcnxJ7YEGOIySgB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpopendata~japan-used-cars-carsensor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpopendata-japan-used-cars-carsensor", "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/jpopendata~japan-used-cars-carsensor/runs": { "post": { "operationId": "runs-sync-jpopendata-japan-used-cars-carsensor", "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/jpopendata~japan-used-cars-carsensor/run-sync": { "post": { "operationId": "run-sync-jpopendata-japan-used-cars-carsensor", "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": [ "prefecture" ], "properties": { "prefecture": { "title": "Prefecture", "type": "string", "description": "REQUIRED. Prefecture of the selling dealers: JIS code (\"27\"), Japanese (\"大阪府\") or English (\"Osaka\"). carsensor.net static list pages are prefecture-scoped.", "default": "Osaka" }, "maker": { "title": "Maker (brand)", "type": "string", "description": "Optional maker filter, applied upstream via the static maker/prefecture list pages. English (\"Toyota\"), Japanese (\"トヨタ\") or a carsensor code (\"bTO\"). Leave empty for all makers. Unrecognized values fail loudly (the README lists supported makers)." }, "model": { "title": "Model keyword", "type": "string", "description": "Optional case-insensitive substring filter on the model/grade name (e.g. \"プリウス\", \"Land Cruiser\" as published — Japanese usually matches best), applied client-side after parsing." }, "priceMin": { "title": "Min base price (万円)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Optional lower bound on the base vehicle price, in 万円 (10,000 JPY units — e.g. 50 = ¥500,000). Applied client-side." }, "priceMax": { "title": "Max base price (万円)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Optional upper bound on the base vehicle price, in 万円. Applied client-side." }, "yearMin": { "title": "Min first-registration year", "minimum": 1940, "maximum": 2100, "type": "integer", "description": "Optional lower bound on the first registration year (初度登録, e.g. 2018). Applied client-side." }, "yearMax": { "title": "Max first-registration year", "minimum": 1940, "maximum": 2100, "type": "integer", "description": "Optional upper bound on the first registration year. Applied client-side." }, "detailFetch": { "title": "Fetch vehicle detail pages", "type": "boolean", "description": "When true, each vehicle costs one extra request but adds drive type, engine type, steering side, seats, doors, exact color and the dealer's business address. When false (default) the actor emits list data only (name, prices, year, mileage, repair history, transmission, displacement, dealer name/city) — cheaper.", "default": false }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many dataset records.", "default": 30 }, "maxApiRequests": { "title": "Max upstream requests", "minimum": 1, "maximum": 60, "type": "integer", "description": "Hard budget of HTTP requests to carsensor.net for this run (list pages of 30 vehicles + 1 per vehicle detail when detailFetch is on). Requests are strictly serial with >= 1.2 s spacing. When the budget runs out the run completes with complete=false in RUN_SUMMARY.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Default: no proxy. Never used for rotation/evasion — one client identity per run." } } }, "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 } } } } } } } } } }