{ "openapi": "3.0.1", "info": { "title": "Carsensor Scraper — Japan Used Cars (JDM Export Data)", "description": "Carsensor scraper for Japan used car data: listings from carsensor.net with price, year, mileage, repair history, inspection and dealer info by maker/prefecture — English schema for JDM export sourcing. Unofficial; not affiliated with Recruit Co., Ltd.", "version": "0.1", "x-build-id": "gfHlxzOumnZLsfki9" }, "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", "enum": [ "Hokkaido", "Aomori", "Iwate", "Miyagi", "Akita", "Yamagata", "Fukushima", "Ibaraki", "Tochigi", "Gunma", "Saitama", "Chiba", "Tokyo", "Kanagawa", "Niigata", "Toyama", "Ishikawa", "Fukui", "Yamanashi", "Nagano", "Gifu", "Shizuoka", "Aichi", "Mie", "Shiga", "Kyoto", "Osaka", "Hyogo", "Nara", "Wakayama", "Tottori", "Shimane", "Okayama", "Hiroshima", "Yamaguchi", "Tokushima", "Kagawa", "Ehime", "Kochi", "Fukuoka", "Saga", "Nagasaki", "Kumamoto", "Oita", "Miyazaki", "Kagoshima", "Okinawa" ], "type": "string", "description": "REQUIRED. Choose one of the 47 prefectures by its English name (e.g. \"Tokyo\", \"Osaka\", \"Kyoto\"). Via API/CLI pass the English name exactly as listed (e.g. \"Tokyo\", not \"東京都\" / \"13\" / \"tokyo-to\" — the platform validates the list before the run starts and rejects anything else with the list of valid values). Cities are NOT prefectures: use \"Kanagawa\" for Yokohama, \"Aichi\" for Nagoya, \"Osaka\" for Osaka-shi. carsensor.net list pages are prefecture-scoped (the prefecture of the selling dealer).", "default": "Osaka" }, "maker": { "title": "Maker (brand)", "enum": [ "", "Toyota", "Lexus", "Nissan", "Honda", "Mazda", "Subaru", "Suzuki", "Mitsubishi", "Daihatsu", "Isuzu", "Mitsuoka", "Hino", "Mitsubishi Fuso", "UD Trucks", "Mercedes-Benz", "BMW", "Audi", "Volkswagen", "Porsche", "Mini", "Volvo", "Peugeot", "Renault", "Citroen", "Fiat", "Alfa Romeo", "Abarth", "Jeep", "Chevrolet", "Ford", "Cadillac", "Dodge", "Chrysler", "Tesla", "Jaguar", "Land Rover", "Rolls-Royce", "Bentley", "Aston Martin", "McLaren", "Lotus", "Ferrari", "Lamborghini", "Maserati", "Smart", "Opel", "DS", "Alpine", "Saab", "BYD", "Hyundai", "Kia" ], "type": "string", "description": "Optional. Leave empty for ALL makers. Otherwise one maker, applied upstream via the static maker/prefecture list pages. Via API the Japanese name (\"トヨタ\"), common aliases (\"Benz\", \"VW\") or the carsensor code (\"bTO\") are accepted too; anything else stops the run immediately with the list of supported makers.", "default": "" }, "model": { "title": "Model keyword", "type": "string", "description": "Optional. Case-insensitive substring filter on the model/grade name as published (e.g. \"プリウス\", \"Land Cruiser\" — Japanese usually matches best), applied client-side after parsing; a rare model may need a higher maxApiRequests to fill maxItems." }, "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): 50 = ¥500,000, 150 = ¥1,500,000. Applied client-side. Leave empty for no minimum." }, "priceMax": { "title": "Max base price (万円)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Optional. Upper bound on the base vehicle price in 万円 (10,000 JPY units): 150 = ¥1,500,000 — NOT 1500000. Applied client-side. Leave empty for no maximum." }, "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, e.g. 2024. Applied client-side." }, "detailFetch": { "title": "Fetch vehicle detail pages", "type": "boolean", "description": "Optional, default false. 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": "Optional, default 10. Stop after this many vehicle records (1..10000). Each list page yields up to 30 vehicles; with detailFetch each record also needs one detail request, so raise maxApiRequests accordingly.", "default": 10 }, "maxApiRequests": { "title": "Max upstream requests", "minimum": 1, "maximum": 60, "type": "integer", "description": "Optional, default 30. 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 still SUCCEEDS with the records collected so far and complete=false in RUN_SUMMARY (not an error).", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Apify proxy settings. Default: no proxy (direct connection). Never used for rotation/evasion — one client identity per run. Set only if carsensor.net starts refusing the runtime IP (HTTP 403)." } } }, "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 } } } } } } } } } }