# Carsensor 日本二手车 Japan Used Car Price & Mileage Stats (`jpmarketdata/carsensor-market-cn`) Actor

日本二手车出口与 JDM 跨境采购必备：输入车种代码，一次调用即可拿到 Carsensor（カーセンサー，日本最大的二手车信息平台）该车种的行情——支付总额（含全部费用）的中位数与四分位、行驶里程、年式分档明细、无修复历史（无事故）比例、MT/AT 构成、库存所在都道府县，并附美元换算。按新着顺取样，不受广告排序影响。From $0.02 per model, no subscription.

- **URL**: https://apify.com/jpmarketdata/carsensor-market-cn.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Japan Used Car Market Price & Mileage Stats — for Chinese-Speaking Buyers

**中文 · English · 日本語** —— 输入一个车种代码，一次调用拿到カーセンサー（Carsensor）上该车种的日本国内行情：支付总额的中位数与四分位、行驶里程、年式分档明细、无修复历史比例、MT/AT 构成与库存所在都道府县。

***

### 中文说明

#### 这是给谁用的（Who this is for）

**日本二手车出口是一门正在发生的生意，而中文圈的买家（含 JDM 玩家、平行进口商、出口代理）几乎都是照着日本国内的挂牌行情来定价的**——不管你是要从日本发一台兰德酷路泽 70 出去，还是要给手上的库存报一个价，问题都是同一个：这台车现在在日本卖多少钱。

**カーセンサー（Carsensor，Recruit 运营）是日本最大的二手车信息平台**，它的车种页面就是日本零售端最完整的公开挂牌样本。而真正的批发端数据——**USS 等业者拍卖会的成交价——是会员制且付费的**，外部拿不到。所以这个 Actor 提供的，是同一批车在**公开零售市场**上的参照价：一次调用，直接可用。

这个 Actor 返回的是可以直接进报价单的行情记录：

- **支付总额行情**（支払総額 —— 含全部手续费的落地价，也就是你出口采购时真正要付的那个数）—— 中位数 / 四分位 / 最低 / 最高。
- **行驶里程统计**（km）与**年式中位数**。
- **年式分档明细** —— 样本里每一个年式的在售台数、支付总额中位数、行驶里程中位数。
- **修复历史构成** —— 申报为无事故（修復歴なし）的车辆占比。
- **MT/AT 构成**、排量中位数、**库存所在都道府县 Top**（货实际堆在哪个县）。
- 可选：每一台取样车辆（价格、年式、行驶里程、修复历史、变速箱、所在地、URL）。

价格以日元给出，可选附上美元换算。取样按**新着顺（newest-first）**，所以统计反映的是当前市场，而不是广告加权后的排序。数据按需从 Carsensor 的公开车种页面获取，运行之间不存储任何数据。

本 Actor 是英文版 [Carsensor Japan Used Cars](https://apify.com/jpmarketdata/carsensor-market-checker) 的**中文语言包**：抓取逻辑与统计口径完全相同，只有标题、商店说明、文档和输入项标签改写成中文。

中日术语对照：支付总额 = `支払総額`（含税含手续费的落地价）／年式 = `年式`（车型年份）／行驶里程 = `走行距離`／修复历史 = `修復歴`，无事故 = `修復歴なし`／变速箱 = `ミッション`（MT・AT）／排量 = `排気量`／都道府县 = `都道府県`。

#### 概览 Overview

每个车种返回**一条 `model_summary` 汇总记录**：支付总额统计、行驶里程统计、年式中位数、年式分档明细、无修复历史比例、MT/AT 构成、排量中位数、都道府县 Top、全站命中总数、取样条数、汇率。开启单车明细后，另外为每一台取样车辆返回一条记录。

#### 输入 Input

| 字段 | 示例 | 说明 |
|---|---|---|
| `models` | `["bTO/s149"]` | Carsensor 车种代码（`b<厂商>/s<车种>`），也可以直接粘贴车种页面的完整 URL。bTO/s149 = 兰德酷路泽70、bTO/s253 = 兰德酷路泽300、bTO/s122 = 普锐斯、bTO/s185 = 海狮 Van、bTO/s009 = 埃尔法。代码就写在车种页面 URL 里：`carsensor.net/usedcar/bTO/s149/` → `bTO/s149`。每个车种 $0.02 |
| `maxListingsPerModel` | `60` | 每个车种取样多少条**最新**车源（30–300，30 = 一个结果页） |
| `includeIndividualListings` | `false` | 开启后输出每一台车的记录（+$0.002/条） |
| `convertToUsd` | `true` | 按当前汇率附上美元统计 |

```json
{
    "models": ["bTO/s149", "bTO/s185"],
    "maxListingsPerModel": 60,
    "includeIndividualListings": false,
    "convertToUsd": true
}
```

#### 输出 Output

字段名保持英文，这是 API 接口：

```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
}
```

怎么读：`totalPriceJpy.median` 是**现在在日本零售端拿下这台车的落地价水位**（支払総額，含全部费用）；`byModelYear` 直接对应海外买家最常问的那个问题——「2015 年式、跑了 10 万公里的，值多少钱？」；`prefectureTop` 告诉你货堆在哪个县，也就是你的日本国内运输成本从哪里起算。

#### 每项统计的口径（basis）

- **所有统计都是样本统计。** 样本 = 按新着顺取样的 `sampledListings` 条（上限为 `maxListingsPerModel`）。想要更稳的分布就调高 `maxListingsPerModel`。
- **`totalListingsFound` 是全站命中总数**，只用来给出这个车种的市场规模背景，**不是统计的母数**。样本与总体这两件事请分开看。
- **`prefectureTop` / `transmissionSplit` / `pctRepairHistoryNone` 同样基于样本**，反映的是取样这批车的构成，不是全站库存的构成。
- **`pctRepairHistoryNone` 只在有申报的车辆中计算**，来源是卖家申报的 `修復歴`。

#### 本 Actor 不做什么

- **不提供拍卖会 / 批发成交数据。** USS 等业者拍卖是会员制付费的，本 Actor 只看公开零售挂牌。
- **不给出挂牌时间，因此做不了时间序列，也做不了「在售天数」这类指标。** 车源页面本身不带发布日期。
- **不返回经销商联系方式，也不处理任何个人数据。**
- **不代购、不下单、不办出口报关。** 只读公开页面。

#### 价格 Pricing —— 每个车种 $0.02 起，无订阅

| 计费事件 | 价格 | 何时发生 |
|---|---|---|
| 车种行情汇总（`model-analyzed`） | **$0.02** | 每分析一个车种 |
| 单车明细记录（`listing-scraped`） | **$0.002** | 仅当开启「输出单车明细」时 |

默认运行（1 个车种、只要汇总）花费 **$0.02**。**零结果的车种绝不收费。** 无需订阅。

#### 注意事项 Notes & limits

- 统计基于**新着顺样本**（上限 `maxListingsPerModel`）；`totalListingsFound` 是市场规模参考值，不是统计母数。
- 车源页面不带发布日期，因此无法提供任何「上架时长 / 在售天数」指标。
- 只读且限速（约 1 请求 / 1.5 秒）。无需登录、不涉及个人数据、运行之间不存储任何数据。
- 价格以日元为准，美元数值按当前汇率换算，仅供参考。
- 数据用于市场调研，大额采购前请自行核实车辆状态。

#### 用途 Use cases

- **出口选品** —— 在拍卖会出价之前，先看清兰德酷路泽、海狮、K-Truck 在零售端的现价水位；年式分档明细直接对应进口国的需求结构（「2015 年式、10 万公里的能卖多少」）。
- **给自己的库存定价** —— 用美元把你的报价和日本活的市场行情摆在一起比。
- **市场研究** —— MT 占比、行驶里程分布、库存的地理分布，一个车种一次调用看完。

***

### English

#### Overview

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), mileage stats and median model year, a per-year breakdown (count, median total price, median mileage), the repair-history share (% declared accident-free), the MT/AT mix, median engine displacement and the top prefectures — plus, optionally, every sampled car.

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.

This listing is the **Chinese-language package** of our English Actor [Carsensor Japan Used Cars](https://apify.com/jpmarketdata/carsensor-market-checker). The scraping and the statistics are identical; the documentation, store copy and input labels are written for Chinese-speaking exporters, importers and JDM buyers (日本二手车 / 支付总额 / 修复历史).

#### Input

| Field | Example | Notes |
|---|---|---|
| `models` | `["bTO/s149"]` | Carsensor model codes (`b<maker>/s<model>`) 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 (+$0.002 each) |
| `convertToUsd` | `true` | Adds USD stats at the current exchange rate |

#### Output

One `type: "model_summary"` record per model (`totalPriceJpy`, `mileageKm`, `modelYearMedian`, `byModelYear`, `pctRepairHistoryNone`, `transmissionSplit`, `displacementCcMedian`, `prefectureTop`, `totalListingsFound`, `sampledListings`, USD conversion) — see the JSON example in the Chinese section — plus optionally one `car_listing` record per sampled car (price, year, mileage, repair history, transmission, location, URL). Prices are reported in JPY and optionally USD.

#### Pricing

| Event | Price |
|---|---|
| Model market summary (`model-analyzed`) | **$0.02** |
| Individual car listing (`listing-scraped`) | **$0.002** each |

Individual listings are OFF by default, so a default run is a flat **$0.02** per model. A model that returns zero listings is never charged. No subscription.

#### Notes & limits

- Statistics are computed over a **newest-first sample** (up to `maxListingsPerModel`); `totalListingsFound` is the full market size, given for context only — sample and population are different numbers.
- Listing pages carry no publication date, so no time-on-market metric is possible.
- No auction/wholesale (USS) data, no dealer contact details or personal data, no purchase or export brokering, no time series.
- Read-only and throttled (~1 request / 1.5 s). No login, no personal data, nothing stored between runs.

***

### 日本語

#### 概要 Overview

カーセンサー掲載の中古車相場を車種単位で1コールで返す Actor です。支払総額（諸費用込み）の中央値・四分位、走行距離、年式中央値と年式別の相場内訳、修復歴なし率、MT/AT 構成、排気量中央値、都道府県分布を**新着順サンプリング**で集計します。中国語圏の利用者（輸出業者・並行輸入・JDM バイヤー）向けに中国語で書き直したパッケージで、英語版は [Carsensor Japan Used Cars](https://apify.com/jpmarketdata/carsensor-market-checker)（取得・統計処理は同一）。フィールド名は英語、USD 換算付き。

#### 入力 Input

`models`（カーセンサーの車種コード、例 `bTO/s149` = ランクル70。車種ページのURLをそのまま貼っても可。コードはURLの `/usedcar/bTO/s149/` 部分）／`maxListingsPerModel`（既定 60、30〜300）／`includeIndividualListings`（既定 OFF）／`convertToUsd`（既定 ON）。

#### 出力 Output

車種ごとに `model_summary` を1件（`totalPriceJpy` / `mileageKm` / `modelYearMedian` / `byModelYear` / `pctRepairHistoryNone` / `transmissionSplit` / `displacementCcMedian` / `prefectureTop` / `totalListingsFound` / `sampledListings` / USD換算）。`includeIndividualListings` が ON のときは、取得した各車両の明細（支払総額・年式・走行距離・修復歴・ミッション・所在地・URL）も出力します。

#### 料金 Pricing

車種サマリー（`model-analyzed`）**$0.02**／個別車両レコード（`listing-scraped`）**$0.002 / 台**。個別明細は**既定 OFF** なので既定実行は車種あたり $0.02 固定です。**0件の車種には課金されません。** サブスクリプション不要。

#### 注意 Notes

統計はすべて**新着順サンプル基準**（母数は `sampledListings`、上限 `maxListingsPerModel`）です。`totalListingsFound` は市場規模の参考値であり、統計の母数ではありません。掲載ページに掲載日が無いため**掲載期間・時系列分析はできません**。オークション（USS）等の業販データは扱わず、販売店の連絡先や個人情報も取得しません。購入代行・輸出手配は行いません。リクエストは約1.5秒間隔、ログイン不要・実行間の保存なし。

# Actor input Schema

## `models` (type: `array`):

一个或多个 Carsensor 车种代码，格式为 'b<厂商>/s<车种>'，也可以直接粘贴 carsensor.net 车种页面的完整 URL。示例：bTO/s149 = 丰田 兰德酷路泽70、bTO/s253 = 兰德酷路泽300、bTO/s122 = 普锐斯、bTO/s185 = 海狮 Van、bTO/s009 = 埃尔法。代码就写在车种页面的 URL 里：carsensor.net/usedcar/bTO/s149/ → bTO/s149。

## `maxListingsPerModel` (type: `integer`):

每个车种取样多少条最新车源。30 = 一个结果页。取样越多统计越稳。仅在开启「输出单车明细」时才影响费用（+$0.002/条）。

## `includeIndividualListings` (type: `boolean`):

默认关闭：一次运行每个车种的汇总固定 $0.02。开启后还会输出每一台取样车辆（支付总额、年式、行驶里程、修复历史、变速箱、所在地、URL），费用 +$0.002/条。

## `convertToUsd` (type: `boolean`):

按当前汇率（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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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-cn").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "models": ["bTO/s149"] }

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/carsensor-market-cn").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-cn --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jpmarketdata/carsensor-market-cn",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DgTFI3H0qdiugyGgn/builds/gam4KshyID3nTxYvm/openapi.json