{ "openapi": "3.0.1", "info": { "title": "Carsensor Used Cars Scraper (new listing & price-drop alert)", "description": "Search Carsensor (カーセンサー), Japan's largest used-car site, by keyword or list URL: one row per car with total and base price in yen, year, mileage, inspection, repair history, dealer and location - labelled new, price_drop, price_rise or unchanged since your last run.", "version": "0.1", "x-build-id": "cQSc7Gds7FgEyA1bg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~carsensor-used-cars/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-carsensor-used-cars", "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/superslowsloth~carsensor-used-cars/runs": { "post": { "operationId": "runs-sync-superslowsloth-carsensor-used-cars", "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/superslowsloth~carsensor-used-cars/run-sync": { "post": { "operationId": "run-sync-superslowsloth-carsensor-used-cars", "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": { "keywords": { "title": "Search keywords", "type": "array", "description": "One or more free-word searches, exactly as you would type them into Carsensor's search box, e.g. \"プリウス\", \"ランドクルーザー 70\" or \"GT-R\". Each becomes https://www.carsensor.net/usedcar/freeword//index.html. Every keyword and search URL shares the maxItems budget below, in order - keywords first. Spellings that differ only in case are collapsed before anything is fetched.", "items": { "type": "string" } }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Optional. Carsensor result-list URLs copied from your browser - a maker, a model, a region or any filtered search, e.g. https://www.carsensor.net/usedcar/bTO/s004/index.html. The URL must be a /usedcar/.../index.html list page (a page number such as index3.html is kept and the run starts there); single-car detail pages and anything off carsensor.net are skipped and reported in the run log.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "newest", "oldest", "total_price_asc", "total_price_desc", "base_price_asc", "base_price_desc", "year_newest", "year_oldest", "mileage_asc", "mileage_desc", "site_default" ], "type": "string", "description": "The order cars are read in. Newest listings first is the default and the right one for an alert: with maxItems 100 each run watches the 100 most recently listed cars. Applies to keywords, and to search URLs that do not already carry a SORT parameter of their own (an order you picked in the browser wins).", "default": "newest" }, "maxItems": { "title": "Max cars", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after reading this many cars in total, shared across every keyword and search URL. Carsensor shows 30 cars per page, so up to 30 per search costs one page request. With 'Only changes' on, this is the window watched - cars read but unchanged since last run are skipped and not charged, and the run still stops here.", "default": 100 }, "changesOnly": { "title": "Only changes since last run", "type": "boolean", "description": "Output (and pay for) only cars that are new since the previous run of the same search, or whose total price (支払総額) went down or up. The first run of a search has nothing to compare with, so it labels every car new and outputs all of them; the memory is kept per search in a named key-value store on your account (carsensor-used-cars-watch). Leave off to get every car, each still labelled new / price_drop / price_rise / unchanged.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy by default. Measured 2026-10-05: carsensor.net answered a datacenter exit from inside Apify with HTTP 200 and the full results page. Switch to RESIDENTIAL only if runs start reporting refusals.", "default": { "useApifyProxy": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }