# CarSensor Japan Scraper - Used Cars, Prices & Dealers (`abotapi/carsensor-net-scraper`) Actor

Scrape CarSensor (carsensor.net) used car listings across Japan by maker, model, prefecture, filters or URL. Extract prices, year, mileage, inspection, warranty, equipment, quality reports, photos and dealer details. Supports recurring price change monitoring.

- **URL**: https://apify.com/abotapi/carsensor-net-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 car results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## CarSensor Scraper: Japan Used Car Listings, Prices, Specs and Dealers

Collect used car listings from CarSensor (carsensor.net), Japan's largest used car marketplace: total and base price, model year, mileage, vehicle inspection, repair history, warranty, the full equipment list, the quality report, every photo and the selling dealer with address, hours and phone. Search by maker, model, prefecture and filters, or paste result pages, dealer pages and single car pages, and monitor price changes on a schedule.

### Why This Scraper?

- **Two ways in.** Search by maker, model, prefecture, body type, keyword, price, model year range and mileage, or paste any result page, dealer page or single car page.
- **Complete cars.** Each record carries price, year, mileage, inspection, repair history, warranty, drive, transmission, seats, doors, fuel, colour and body type, plus the equipment that is actually fitted, the sample loan example and the model's catalogue specs (dimensions, weight, fuel economy).
- **Quality and photos.** The quality score, the inspector's comment, the inspection date and every photo of the car, plus the 360 view id when the listing has one.
- **Dealer block.** Dealer name, page, address, opening hours, phone, catch copy, review score and count, plus the dealer's coupons and current fair on every car.
- **Price monitoring.** Recurring updates label each car NEW, UPDATED, UNCHANGED, REAPPEARED or EXPIRED, and a price-only mode returns just the cars whose price moved.
- **Resume and export.** Continue an interrupted run, and pipe results into Notion, Linear or Airtable.
- **Transparent billing.** One charge per car, plus one detail charge for each car whose own page was read.

### Use Cases

- **Dealers and traders:** benchmark your stock against live market prices by maker, model, year and mileage.
- **Market analysts:** track asking prices, mileage and equipment trends for a model across prefectures.
- **Exporters and buyers:** build shortlists with photos, quality scores, repair history and dealer contacts.
- **Price alerts:** run a schedule with price-only recurring updates and receive just the cars that got cheaper.
- **Data teams:** feed a clean, flat car dataset into a warehouse or a model.

### Data You Get

> Sample shape: values are illustrative placeholders, not from a live record.

| Field | Example |
| --- | --- |
| `carId` | `AU0000000000` |
| `detailUrl` | `https://www.carsensor.net/usedcar/detail/AU0000000000/index.html` |
| `maker`, `model`, `grade` | `Example Maker`, `Example Model`, `2.0 Example Grade 4WD` |
| `totalPriceManYen`, `basePriceManYen` | `250.5`, `239.8` (10,000 yen) |
| `totalPriceJpy`, `basePriceJpy` | `2505000`, `2398000` |
| `year`, `yearJp`, `mileageKm`, `mileageText` | `2021`, `R03`, `32000`, `3.2万km` |
| `inspection`, `repairHistory` | `2027(R09)年6月`, `なし` |
| `warranty`, `warrantyDetail`, `legalMaintenanceDetail` | `保証付`, full warranty text, full maintenance text |
| `monthlyLoanJpy`, `loan` | `73800`, object with `loanType`, `monthlyPaymentJpy`, `annualRatePercent`, `firstPaymentJpy`, `downPaymentJpy`, `installments`, `bonusAddition`, `totalInstallmentPriceJpy` |
| `catalogSpecs` | object with `releaseDate`, `dimensions`, `lengthMm`, `widthMm`, `heightMm`, `wheelbase`, `weight`, `interiorDimensions`, `fuelEconomyWltc`, `minTurningRadius` |
| `displacementCc`, `transmission`, `drive`, `steering` | `1986`, `フロアCVT`, `4WD`, `右` |
| `seats`, `doors`, `fuel`, `engineType`, `bodyType`, `color` | `5`, `5`, `ガソリン`, `ガソリン`, `ミニバン`, `白` |
| `equipment` | `["ETC", "スマートキー", "ドライブレコーダー"]` |
| `qualityScore`, `qualityComment`, `qualityInspectionDate` | `4.5`, inspector comment, `2026-10-31` |
| `labels` | `["360°画像付", "車両品質評価書付"]` |
| `mainImageUrl`, `imageUrls`, `imageCount`, `view360CarId` | first photo, all photos, `60`, `U00000000000` |
| `prefecture`, `city`, `region` | `東京都`, `Example City`, `関東` |
| `makerCode`, `makerEn`, `prefectureCode`, `prefectureEn` | `TO`, `Toyota`, `35`, `Tokyo` |
| `shopId`, `shopName`, `shopUrl`, `shopCatch` | `000000000`, `Example Motors`, dealer page, catch copy |
| `shopAddress`, `shopHours`, `shopPhone`, `shopPhoneNote` | address, `10:00～18:30`, `0078-0000-000000`, dial note |
| `shopCoupons`, `shopOffer`, `shopImageUrl` | list of `type`, `title`, `validity`; fair headline; banner image |
| `shopReviewScore`, `shopReviewCount`, `detailError` | `4.5`, `100`, set only when a car's own page could not be read |
| `searchUrl`, `page`, `scrapedAt` | result page link, `1`, timestamp |

Recurring-update rows add `changeType`, `changedFields`, `firstSeenAt` and `lastSeenAt`.

### How to Use

1. Pick a mode: **Search by filters** or **Paste links**.
2. Set the filters (maker, model, prefecture, body type, keyword, price, model year range, mileage, sort) or paste your links.
3. Set **Max items** (default 20) and leave **Read each car's own page** on for the full record.
4. Run the actor and download the dataset as JSON, CSV or Excel.

**Search a model in one prefecture:**

```json
{
  "mode": "search",
  "maker": "Toyota",
  "model": "S149",
  "prefecture": "chiba",
  "maxItems": 50
}
```

**Search by keyword with filters:**

```json
{
  "mode": "search",
  "keywords": "プリウス",
  "minPrice": 1000000,
  "maxPrice": 2000000,
  "minYear": 2018,
  "maxYear": 2023,
  "bodyType": "suv",
  "maxMileageKm": 50000,
  "sortBy": "totalPriceAsc",
  "maxItems": 100
}
```

**Paste links:**

```json
{
  "mode": "url",
  "urls": [
    "https://www.carsensor.net/usedcar/bTO/s149/index.html",
    "https://www.carsensor.net/usedcar/detail/AU0000000000/index.html",
    "https://www.carsensor.net/shop/chiba/000000000/"
  ],
  "maxItems": 100
}
```

#### Supported links

Result pages for the whole country, a maker, a maker and model, a maker, model and prefecture, a body-type page and a search with filters; a maker index page (read as the maker's result list); links with a sort parameter or a later page number; the site address with or without www; single car pages (detail and lease pages, tracking parameters are fine); and dealer pages, whose full stock list is read. Links copied from page source with `&amp;` work too. Pages that are not cars (help, home, other sites) are refused with a message. Pagination starts at the page named in the link and walks forward.

#### Run it from your code

**Python:**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("<ACTOR_ID>").call(run_input={
    "mode": "search",
    "maker": "Toyota",
    "maxItems": 20,
})
for car in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(car["fullTitle"], car["totalPriceManYen"], car["mileageKm"])
```

**JavaScript:**

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('<ACTOR_ID>').call({ mode: 'search', maker: 'Toyota', maxItems: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length);
```

#### Tips

- **Finding a model code:** open the model's result page on the site; the code is the part after the s in the address, for example S149 in /usedcar/bTO/s149/.
- **Keyword with a maker:** the keyword narrows inside the maker, model and prefecture you set.
- **Max items versus max pages:** Max items is the single limit that stops a run. Max pages is an optional guard per search or link and never caps the run on its own.
- **Dealer pages:** a pasted dealer page returns that dealer's whole stock, read from each car's own page, so every row carries the detail charge.

#### Resume and recurring updates

Continue a previous run finishes ONE interrupted run: give its run id and every car it already collected is skipped. Recurring updates is for running the same search on a schedule: each run returns what changed since the last one. Both together are refused once a baseline exists. A run that stopped early, or that started from a pasted page beyond the first, never reports cars as gone.

#### Dataset views

Results (headline fields), Car details (spec table, equipment, quality report, photos), Dealers, and Changes (recurring-update rows).

### Send results into your apps (MCP connectors)

Optionally pipe the scraped cars into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step **after** the scrape: the Apify dataset is never changed.

**What gets written to the connector:** a condensed, human-readable **summary** of each car, not the full JSON. Each car becomes one entry with a **title** and its key fields flattened to plain text. The **complete record always stays in the Apify dataset**.

1. Authorize a connector once under **Apify > Settings > Integrations** (Notion, Linear, Airtable, or Apify).
2. Select it in the **"Pipe results into your apps"** input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For **Notion**, also set `notionParentPageUrl` to the page where cars should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

### Input Parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | `search` | `search` filters or `url` pasted links. |
| `keywords` | string | none | Free-text search, for example a model name. |
| `maker` | string | none | Maker code (TO), Japanese name or common English name. |
| `model` | string | none | Model code from the site's address, for example S149. Needs a maker. |
| `prefecture` | string | any | One of the 47 prefectures. |
| `minPrice` | integer | none | Lowest total price in yen. |
| `maxPrice` | integer | none | Highest total price in yen. |
| `minYear` | integer | none | Earliest model year. |
| `maxYear` | integer | none | Latest model year. |
| `bodyType` | string | `any` | Coupe, minivan, hatchback, wagon, convertible, SUV, pickup, sedan, truck or other. |
| `maxMileageKm` | integer | none | Highest mileage in km. |
| `sortBy` | string | `default` | Site default, newest, price ascending or descending, newest year, lowest mileage. |
| `urls` | array | sample links | Result pages, dealer pages and single car pages. |
| `fetchDetails` | boolean | `true` | Read each car's own page for the full record. |
| `maxPages` | integer | none | Optional guard per search or link; empty means no page limit. |
| `maxItems` | integer | `20` | The single limit that stops a run; 0 means no limit. |
| `proxy` | object | standard Apify proxy | Proxy settings. |
| `resumeFromRunId` | string | none | Run id of an interrupted run to continue. |
| `incrementalMode` | boolean | `false` | Label cars against the previous run of the same setup. |
| `stateKey` | string | none | Name the baseline of a recurring schedule. |
| `emitUnchanged` | boolean | `false` | Also return unchanged cars. |
| `emitExpired` | boolean | `false` | Also return cars that are gone. |
| `changeScope` | string | `all` | Any listing field, or price only. |
| `compactUpdates` | boolean | `false` | Short rows for updated and gone cars. |
| `expireAfterMissedScans` | integer | `1` | Complete scans a car must be missing before it is marked gone. |
| `ignoreFieldsForChanges` | array | none | Fields that never make a car UPDATED. |
| `mcpConnectors` | array | none | Connectors to pipe results into after the run. |
| `notionParentPageUrl` | string | none | Notion parent page for the Notion connector. |
| `maxNotifyListings` | integer | `50` | Rows each connector receives per run. |

### Output Example

> Sample shape: values are illustrative placeholders, not from a live record.

```json
{
  "carId": "AU0000000000",
  "detailUrl": "https://www.carsensor.net/usedcar/detail/AU0000000000/index.html",
  "maker": "Example Maker",
  "model": "Example Model",
  "grade": "2.0 Example Grade 4WD",
  "fullTitle": "Example Maker Example Model 2.0 Example Grade 4WD",
  "totalPriceManYen": 250.5,
  "basePriceManYen": 239.8,
  "totalPriceJpy": 2505000,
  "year": 2021,
  "mileageKm": 32000,
  "inspection": "2027(R09)年6月",
  "repairHistory": "なし",
  "warranty": "保証付",
  "displacementCc": 1986,
  "transmission": "フロアCVT",
  "drive": "4WD",
  "seats": 5,
  "equipment": ["ETC", "スマートキー"],
  "qualityScore": 4.5,
  "labels": ["360°画像付"],
  "mainImageUrl": "https://example.com/photo.jpg",
  "prefecture": "東京都",
  "shopName": "Example Motors",
  "shopAddress": "Example address",
  "shopPhone": "0078-0000-000000",
  "shopReviewScore": 4.5,
  "shopReviewCount": 100,
  "page": 1,
  "scrapedAt": "2026-01-01T00:00:00Z"
}
```

### Plan Requirement

The default proxy setting is the standard Apify proxy pool. In our checks the site served its pages through that pool without any special setup, so a standard run needs no action. The standard pool works on every plan; Residential is recommended for the most reliable results on large or frequent runs. If you select Residential, the run still tries the cheaper standard pool first and moves to Residential only if the site refuses it.

What the run does, in order:

1. It starts on the standard Apify proxy pool.
2. If that pool is refused for your account, or keeps failing, it tries Apify Residential, which only paid Apify plans include. Residential traffic from this automatic step is billed to your own Apify plan, and the run limits how much it uses. Apify free plans do not include residential proxies, and then the log prints "The selected connection is unavailable to this run" with a pointer to https://apify.com/pricing.
3. It then continues on a backup connection, and the log says "Served over the backup connection" once that connection serves a page. On a free plan some pages may still be unavailable.
4. If every connection is refused, the run stops as failed with "The proxy connection was refused for this account, so no page could be read" (a paid Apify plan is required) instead of returning an empty dataset. If only the backup connection was left and it could not load the pages, the message reads "No results: residential proxies are unavailable on this run".
5. A page that is refused by the site, or cannot be read within the per-page time limit (about 25 seconds), skips that source with a notice in the log, and the run keeps the other sources. If no results page loaded at all, the run ends with "Could not load any results page ... This is a connection problem, not an empty search".

If you hit these messages, switch to a paid Apify plan, or supply your own proxy URLs in the proxy field (a single custom proxy is used as is, with no backup connection). For very large runs Residential is the most reliable choice.

Billing for each event is in the FAQ below, and the **Pricing** tab shows the current rates.

### FAQ

#### How much does it cost?

The run is billed on three events, and the **Pricing** tab shows the current rate of each:

- **Car result:** once for every record written to the dataset, including a short `UPDATED` row.
- **Detail enrichment:** once for every car whose own page was read and merged into a record you receive, whether you left car page reading on, pasted a car link or pasted a dealer page. A car that is not written (an unchanged one in recurring updates) is not charged this event, and neither is a short `UPDATED` row (`compactUpdates`), which carries no detail fields.
- **Actor Start:** once per GB of memory when the run starts, at least one.

Use **Max items** to cap the cost of any run.

#### Is it legal to scrape CarSensor?

This actor collects only publicly available listing data. You are responsible for how you use it: follow the site's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Listing photos and dealer copy may carry their own rights separate from the underlying facts.

#### Can I get only new or changed cars on a schedule?

Yes. Schedule the actor from the **Schedules** tab and turn on **recurring updates**. Each run then returns only new and updated cars, unchanged ones are not billed, and gone cars can be reported too once a run has scanned its scope end to end. Choose **Price only** to be told just about price moves.

#### Why were no gone cars reported this run?

Gone cars are only reported after a run that read every one of its sources to the end. If a limit stopped the run, a source hit **Max pages** or ran out of **Max items** partway through, a source failed, a pasted page started beyond the first, or the run continued a previous one, detection is skipped for the whole run (the run log says why) and the cars stay tracked. The next complete run reports them.

#### Why are the equipment list, photos or dealer address empty?

Those fields come from a car's own page. Leave **Read each car's own page** on, or paste car links directly; they are always read in full. The result page alone carries price, year, mileage, inspection, warranty, area and the dealer name.

#### Why did my run fail instead of returning an empty dataset?

If every page the run tried was refused, the run stops with a clear message so "no cars for this search" is never confused with "nothing could be read". Run it again in a few minutes. If only some links failed, you still get what was found, with a notice.

#### Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear or Airtable.

### 🔗 Want more car data?

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>🚗 <a href="https://apify.com/abotapi/mobile-de-scraper"><b>mobile.de Scraper</b></a><br>Scrape mobile.de vehicle listings with 30+ fields including price, mileage, registration...</td><td>🚗 <a href="https://apify.com/abotapi/auto-ru-scraper"><b>Auto.ru Scraper</b></a><br>Scrape Auto.ru car listings: search by make, model, year, price, mileage, body, engine...</td></tr>
<tr><td>🚗 <a href="https://apify.com/abotapi/cars-com-scraper"><b>Cars.com Scraper</b></a><br>Scrape cars.com listings by make, ZIP and radius. 90+ fields per car: price, MSRP...</td><td>🚗 <a href="https://apify.com/abotapi/autotrader-com-scraper"><b>Autotrader US</b></a><br>Scrape US car listings from Autotrader by make, model, ZIP, price, year, body style...</td></tr>
<tr><td>🚗 <a href="https://apify.com/abotapi/autoscout24-scraper"><b>AutoScout24 Scraper</b></a><br>A lean, production-grade scraper for autoscout24.com. Point it at a search, get back...</td><td>🚗 <a href="https://apify.com/abotapi/autotrader"><b>AutoTrader UK Scraper</b></a><br>Pull structured vehicle listings from autotrader.co.uk at scale. Search by filters or use...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/carsensor-net-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

Search by filters walks the result pages for the maker, model, prefecture and filters below. Paste links walks the links you paste, forward from the page each link names.

## `keywords` (type: `string`):

Free-text search, for example a model name such as プリウス or a grade or equipment word. Works together with the maker and the prefecture.

## `maker` (type: `string`):

The maker as a code (TO for Toyota, NI for Nissan, HO for Honda), the Japanese name (トヨタ) or a common English name (Toyota). Leave empty for every maker.

## `model` (type: `string`):

The model code from the site's own address, for example S149 for the Land Cruiser 70 (the part after the s in /usedcar/bTO/s149/). Needs a maker. Leave empty for every model of the maker.

## `prefecture` (type: `string`):

Only cars on sale in this prefecture. Any prefecture searches the whole country.

## `minPrice` (type: `integer`):

Lowest total price in yen, taxes and fees included, for example 1000000.

## `maxPrice` (type: `integer`):

Highest total price in yen, taxes and fees included, for example 2000000.

## `minYear` (type: `integer`):

Only cars first registered in this year or later, for example 2018.

## `maxYear` (type: `integer`):

Only cars first registered in this year or earlier, for example 2022.

## `maxMileageKm` (type: `integer`):

Only cars with at most this many kilometres on the clock, for example 50000.

## `bodyType` (type: `string`):

Only cars of this body type, applied by the site itself.

## `sortBy` (type: `string`):

Order of the results, applied by the site itself (checked on the first rows of a model search). The default keeps the site's own order.

## `urls` (type: `array`):

Multi-URL, filter fields ignored, pagination walks forward. Paste result pages (the national list, a maker, a maker and model, a prefecture, a body-type page, a search with filters), a dealer page (its stock list is read) or single car pages (detail and lease pages, tracking parameters are fine). Pagination starts at the page named in the link and walks forward.

## `fetchDetails` (type: `boolean`):

The result page carries price, year, mileage, inspection, warranty, area and the dealer name. A car's own page adds the equipment list, the full photo set, the quality report, the warranty text, the full spec table and the dealer address, hours and phone. A per-car detail-enrichment charge applies to every car whose page was read. Single car links and dealer stock lists are always read from the car pages.

## `maxPages` (type: `integer`):

Optional guard per search or link: stop after this many result pages. Empty or 0 (the default) means no page limit. It does not cap the run and defers to Max items, which is the single cap (default 20).

## `maxItems` (type: `integer`):

The single limit that stops a run. Default 20 cars; 0 means no limit (at most 1,000,000).

## `proxy` (type: `object`):

The site serves its pages to the standard Apify proxy pool, so that is the default. Residential also works and is recommended for the most reliable results on large or frequent runs.

## `resumeFromRunId` (type: `string`):

Give the run id of an interrupted run and every car it already collected is skipped. Mutually exclusive with recurring updates once a baseline exists.

## `incrementalMode` (type: `boolean`):

Label every car NEW, UPDATED, UNCHANGED or REAPPEARED against the previous run of the same setup, and record the ones that vanished as EXPIRED. UPDATED means a compared field moved: total price, base price, mileage, inspection, warranty, repair history, equipment, quality score, photos, dealer details and the other listing facts. Never compared: the run time, the result page number and the search link the car was reached through. Unchanged cars are not returned unless you also turn on the return-unchanged switch. Returns (and bills) extra rows only for what changed.

## `stateKey` (type: `string`):

Name the baseline of a recurring schedule yourself. Without it the baseline is keyed on the whole search setup, so two differently-configured schedules never share one baseline.

## `emitUnchanged` (type: `boolean`):

Returns (and bills) every tracked car again, labelled UNCHANGED, instead of only the changed ones.

## `emitExpired` (type: `boolean`):

Cars tracked by the previous run but absent from a COMPLETE scan are returned (and billed) one last time, labelled EXPIRED. A run that stopped early never reports cars as gone.

## `changeScope` (type: `string`):

Any listing field: every compared field can make a car UPDATED. Price only: just the total price, base price and extra costs decide UPDATED, so equipment, photo and dealer-copy edits never produce a returned row. Changing this changes which baseline an automatic state key uses.

## `compactUpdates` (type: `boolean`):

UPDATED and EXPIRED rows come back short: ids, link, title, current prices and priceChanges with the old and new value of each moved field. New cars stay full. The per-car detail charge is not applied to a short row because it carries no detail fields.

## `expireAfterMissedScans` (type: `integer`):

With the gone-cars switch on, a car is returned as EXPIRED only after it was missing from this many complete scans in a row. A car that left the results and a sold one look the same without opening each car page.

## `ignoreFieldsForChanges` (type: `array`):

Field names that never make a car UPDATED and are left out of changedFields (they stay in the output). Use a dotted path to ignore one key inside a nested list, for example planPrices.plan. Leave empty to compare every listing field. Changing this changes which baseline an automatic state key uses.

## `mcpConnectors` (type: `array`):

Optional delivery step AFTER the scrape: pipes dataset results into apps you connected in the Apify MCP Connector setup.

## `notionParentPageUrl` (type: `string`):

Notion connector only: the parent page new Notion pages attach under.

## `maxNotifyListings` (type: `integer`):

How many dataset rows at most each connector receives per run.

## Actor input object example

```json
{
  "mode": "search",
  "prefecture": "",
  "bodyType": "any",
  "sortBy": "default",
  "urls": [
    "https://www.carsensor.net/usedcar/",
    "https://www.carsensor.net/usedcar/bTO/index.html",
    "https://www.carsensor.net/usedcar/bTO/s149/index.html",
    "https://www.carsensor.net/usedcar/bTO/s149/index2.html",
    "https://www.carsensor.net/usedcar/bTO/s149/a34/index.html",
    "https://www.carsensor.net/usedcar/bodytype/suv/index.html",
    "https://www.carsensor.net/usedcar/search.php?KW=%E3%83%97%E3%83%AA%E3%82%A6%E3%82%B9&PMIN=1000000&PMAX=2000000&YMIN=2018&SMAX=50000",
    "https://www.carsensor.net/usedcar/bTO/s149/index.html?SORT=2",
    "https://www.carsensor.net/usedcar/shashu/bTO/index.html",
    "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html",
    "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html?TRCD=200002&RESTID=CS210610",
    "https://www.carsensor.net/usedcar/lease/AU7174821896/",
    "https://www.carsensor.net/shop/chiba/312461002/",
    "https://carsensor.net/usedcar/"
  ],
  "fetchDetails": true,
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "changeScope": "all",
  "compactUpdates": false,
  "expireAfterMissedScans": 1,
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detail` (type: `string`):

No description

## `dealer` (type: `string`):

No description

## `changes` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 = {
    "mode": "search",
    "urls": [
        "https://www.carsensor.net/usedcar/",
        "https://www.carsensor.net/usedcar/bTO/index.html",
        "https://www.carsensor.net/usedcar/bTO/s149/index.html",
        "https://www.carsensor.net/usedcar/bTO/s149/index2.html",
        "https://www.carsensor.net/usedcar/bTO/s149/a34/index.html",
        "https://www.carsensor.net/usedcar/bodytype/suv/index.html",
        "https://www.carsensor.net/usedcar/search.php?KW=%E3%83%97%E3%83%AA%E3%82%A6%E3%82%B9&PMIN=1000000&PMAX=2000000&YMIN=2018&SMAX=50000",
        "https://www.carsensor.net/usedcar/bTO/s149/index.html?SORT=2",
        "https://www.carsensor.net/usedcar/shashu/bTO/index.html",
        "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html",
        "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html?TRCD=200002&RESTID=CS210610",
        "https://www.carsensor.net/usedcar/lease/AU7174821896/",
        "https://www.carsensor.net/shop/chiba/312461002/",
        "https://carsensor.net/usedcar/"
    ],
    "fetchDetails": true,
    "maxItems": 20,
    "proxy": {
        "useApifyProxy": true
    },
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "changeScope": "all",
    "compactUpdates": false,
    "expireAfterMissedScans": 1,
    "maxNotifyListings": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/carsensor-net-scraper").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 = {
    "mode": "search",
    "urls": [
        "https://www.carsensor.net/usedcar/",
        "https://www.carsensor.net/usedcar/bTO/index.html",
        "https://www.carsensor.net/usedcar/bTO/s149/index.html",
        "https://www.carsensor.net/usedcar/bTO/s149/index2.html",
        "https://www.carsensor.net/usedcar/bTO/s149/a34/index.html",
        "https://www.carsensor.net/usedcar/bodytype/suv/index.html",
        "https://www.carsensor.net/usedcar/search.php?KW=%E3%83%97%E3%83%AA%E3%82%A6%E3%82%B9&PMIN=1000000&PMAX=2000000&YMIN=2018&SMAX=50000",
        "https://www.carsensor.net/usedcar/bTO/s149/index.html?SORT=2",
        "https://www.carsensor.net/usedcar/shashu/bTO/index.html",
        "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html",
        "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html?TRCD=200002&RESTID=CS210610",
        "https://www.carsensor.net/usedcar/lease/AU7174821896/",
        "https://www.carsensor.net/shop/chiba/312461002/",
        "https://carsensor.net/usedcar/",
    ],
    "fetchDetails": True,
    "maxItems": 20,
    "proxy": { "useApifyProxy": True },
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "changeScope": "all",
    "compactUpdates": False,
    "expireAfterMissedScans": 1,
    "maxNotifyListings": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/carsensor-net-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "urls": [
    "https://www.carsensor.net/usedcar/",
    "https://www.carsensor.net/usedcar/bTO/index.html",
    "https://www.carsensor.net/usedcar/bTO/s149/index.html",
    "https://www.carsensor.net/usedcar/bTO/s149/index2.html",
    "https://www.carsensor.net/usedcar/bTO/s149/a34/index.html",
    "https://www.carsensor.net/usedcar/bodytype/suv/index.html",
    "https://www.carsensor.net/usedcar/search.php?KW=%E3%83%97%E3%83%AA%E3%82%A6%E3%82%B9&PMIN=1000000&PMAX=2000000&YMIN=2018&SMAX=50000",
    "https://www.carsensor.net/usedcar/bTO/s149/index.html?SORT=2",
    "https://www.carsensor.net/usedcar/shashu/bTO/index.html",
    "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html",
    "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html?TRCD=200002&RESTID=CS210610",
    "https://www.carsensor.net/usedcar/lease/AU7174821896/",
    "https://www.carsensor.net/shop/chiba/312461002/",
    "https://carsensor.net/usedcar/"
  ],
  "fetchDetails": true,
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "changeScope": "all",
  "compactUpdates": false,
  "expireAfterMissedScans": 1,
  "maxNotifyListings": 50
}' |
apify call abotapi/carsensor-net-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/carsensor-net-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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