# Carsensor Japan Used Cars — Market Price & Mileage Stats (`jpmarketdata/carsensor-market-checker`) Actor Used-car market stats for any model on Carsensor, Japan's largest listing site: median total price (all fees in), mileage, per-year breakdown, repair-history share, MT/AT mix. For JDM exporters & cross-border buyers. From $0.02 per model — no subscription. カーセンサーの車種別相場を1コールで。 - **URL**: https://apify.com/jpmarketdata/carsensor-market-checker.md - **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 model market summaries This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Carsensor Japan Used Cars — Market Price & Mileage Stats Market statistics for Japanese used cars, straight from [Carsensor](https://www.carsensor.net) — Japan's largest used-car listing site (run by Recruit). One call per model returns: - **Total price stats** (支払総額 — the real drive-away price including all fees, the number that matters when you buy for export) — median / quartiles / min / max - **Mileage stats** (km) and **median model year** - **Per-year breakdown** — count, median total price and median mileage for every model year in the sample - **Repair-history share** — % of cars declared accident-free (修復歴なし) - **MT/AT mix**, median engine displacement, top prefectures (where the stock actually is) - Optionally, every sampled car (price, year, mileage, repair history, transmission, location, URL) Prices are reported in JPY and (optionally) USD. Listings are sampled **newest-first**, so the stats reflect the current market, not an ad-weighted ranking. Data is fetched on demand from Carsensor's public model pages — nothing is stored between runs. Built for **JDM exporters and cross-border buyers**: the wholesale auction data (USS) is members-only and paid — this gives you the retail-market reference for the same cars in one call. ### Pricing — from $0.02 per model, no subscription | Event | Price | When | |---|---|---| | Model market summary | $0.02 | Per model analyzed | | Individual car listing | $0.002 | Only if you enable **Include individual listings** | A default run (1 model, summary only) costs **$0.02**. You are never charged for a model that returns zero listings. ### Input | Field | Example | Notes | |---|---|---| | `models` | `["bTO/s149"]` | Carsensor model codes (`b/s`) or full model page URLs. bTO/s149 = Land Cruiser 70, bTO/s253 = Land Cruiser 300, bTO/s122 = Prius, bTO/s185 = Hiace Van, bTO/s009 = Alphard. Find the code in any model page URL: `carsensor.net/usedcar/bTO/s149/` | | `maxListingsPerModel` | `60` | Newest listings sampled per model (30–300) | | `includeIndividualListings` | `false` | Enable to get each car as a record | | `convertToUsd` | `true` | Adds USD stats at the current exchange rate | ### Output example (summary) ```json { "type": "model_summary", "model": "bTO/s149", "modelLabel": "トヨタ ランドクルーザー70", "totalListingsFound": 389, "sampledListings": 60, "sampleOrder": "newest-first", "totalPriceJpy": {"min": 4980000, "p25": 6598000, "median": 7299000, "p75": 7799000, "max": 9899000, "average": 7180000}, "totalPriceUsd": {"median": 46500.12, "...": "..."}, "mileageKm": {"min": 2000, "median": 9000, "max": 210000, "...": "..."}, "modelYearMedian": 2024, "byModelYear": [ {"modelYear": 2025, "count": 22, "medianTotalPriceJpy": 7450000, "medianMileageKm": 5000, "medianTotalPriceUsd": 47461.5}, {"modelYear": 2024, "count": 18, "medianTotalPriceJpy": 7100000, "medianMileageKm": 12000, "medianTotalPriceUsd": 45231.0} ], "pctRepairHistoryNone": 96.7, "transmissionSplit": {"AT": 41, "MT": 19}, "displacementCcMedian": 2800, "prefectureTop": [["愛知県", 9], ["大阪府", 7]], "exchangeRateJpyUsd": 0.00637 } ```` ### Use cases - **Export sourcing** — check the current retail market for Land Cruisers, Hiaces or kei trucks before bidding at auction; the per-year breakdown maps directly to importer demand ("what does a 2015 with 100k km go for?") - **Pricing your inventory** — compare your asking price against the live Japanese market, in USD - **Market research** — MT share, mileage distribution and where the stock sits, per model, in one call ### Notes & limits - Statistics are computed over a **newest-first sample** (up to `maxListingsPerModel`); `totalListingsFound` is the full market size for context - Listing pages carry no publication date, so no time-on-market metric is possible - Read-only and throttled (~1 request / 1.5 s). No login, no personal data, nothing stored between runs *** ### 日本語ガイド **カーセンサー掲載の中古車相場を車種単位で1コールで返す Actor です。** - **概要**: 車種ごとに支払総額(諸費用込み)の中央値・四分位、走行距離、年式別の相場内訳、修復歴なし率、MT/AT 構成、都道府県分布を新着順サンプリングで集計します。輸出業者・越境バイヤー向けに英語フィールド名+USD換算付き。 - **使い方**: `models` にカーセンサーの車種コード(例: `bTO/s149` = ランクル70)または車種ページのURLをそのまま入力してください。コードは車種ページURLの `/usedcar/bTO/s149/` 部分です。 - **料金**: 車種サマリー1件 $0.02。個別車両データが必要な場合のみ `includeIndividualListings` を ON(+$0.002/台)。0件の車種には課金されません。サブスクリプション不要です。 # Actor input Schema ## `models` (type: `array`): One or more Carsensor model codes as 'b/s', or full carsensor.net model page URLs. Examples: bTO/s149 = Toyota Land Cruiser 70, bTO/s253 = Land Cruiser 300, bTO/s122 = Prius, bTO/s185 = Hiace Van, bTO/s009 = Alphard. Find the code in any model page URL: carsensor.net/usedcar/bTO/s149/ → bTO/s149. ## `maxListingsPerModel` (type: `integer`): How many newest listings to sample per model. 30 = one result page. More listings = better statistics. Affects cost only when 'Include individual listings' is enabled (+$0.002 per listing). ## `includeIndividualListings` (type: `boolean`): Off by default: a run costs a flat $0.02 per model summary. Enable to also get every sampled car (total price, model year, mileage, repair history, transmission, location, URL) at +$0.002 per listing. ## `convertToUsd` (type: `boolean`): Adds USD statistics next to JPY using the current exchange rate (open.er-api.com). ## Actor input object example ```json { "models": [ "bTO/s149" ], "maxListingsPerModel": 60, "includeIndividualListings": false, "convertToUsd": true } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "models": [ "bTO/s149" ] }; // Run the Actor and wait for it to finish const run = await client.actor("jpmarketdata/carsensor-market-checker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "models": ["bTO/s149"] } # Run the Actor and wait for it to finish run = client.actor("jpmarketdata/carsensor-market-checker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "models": [ "bTO/s149" ] }' | apify call jpmarketdata/carsensor-market-checker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jpmarketdata/carsensor-market-checker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Carsensor Japan Used Cars — Market Price & Mileage Stats", "description": "Used-car market stats for any model on Carsensor, Japan's largest listing site: median total price (all fees in), mileage, per-year breakdown, repair-history share, MT/AT mix. For JDM exporters & cross-border buyers. From $0.02 per model — no subscription. カーセンサーの車種別相場を1コールで。", "version": "0.1", "x-build-id": "bsJskWV08yZ5i4VKO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~carsensor-market-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-carsensor-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~carsensor-market-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-carsensor-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~carsensor-market-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-carsensor-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": [ "models" ], "properties": { "models": { "title": "Car models", "type": "array", "description": "One or more Carsensor model codes as 'b/s', or full carsensor.net model page URLs. Examples: bTO/s149 = Toyota Land Cruiser 70, bTO/s253 = Land Cruiser 300, bTO/s122 = Prius, bTO/s185 = Hiace Van, bTO/s009 = Alphard. Find the code in any model page URL: carsensor.net/usedcar/bTO/s149/ → bTO/s149.", "items": { "type": "string" } }, "maxListingsPerModel": { "title": "Max listings per model", "minimum": 30, "maximum": 300, "type": "integer", "description": "How many newest listings to sample per model. 30 = one result page. More listings = better statistics. Affects cost only when 'Include individual listings' is enabled (+$0.002 per listing).", "default": 60 }, "includeIndividualListings": { "title": "Include individual listings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per model summary. Enable to also get every sampled car (total price, model year, mileage, repair history, transmission, location, URL) at +$0.002 per listing.", "default": false }, "convertToUsd": { "title": "Convert prices to USD", "type": "boolean", "description": "Adds USD statistics next to JPY using the current exchange rate (open.er-api.com).", "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 } } } } } } } } } } ```