CarSensor Used Car Scraper

Scrape CarSensor.net — Japan's largest used-car listing marketplace, operated by Recruit. Search nationwide inventory by maker, keyword, price, model year, mileage, engine displacement, fuel type, and body style, or look up specific listings by ID. Every listing includes real dealer pricing, inspection status, accident history, and warranty info pulled directly from the dealer's own posting. HTTP-only, no login, no API key, no cookies.

What this actor does

• Two modes: search (browse/filter nationwide listings) and byId (look up specific listings by CarSensor listing ID)
• Rich filters: maker/brand, free-text keyword, total price range, model-year range, mileage range, engine displacement range, fuel type, body style, exclude kei (mini) cars
• Real dealer data: dealer/shop name, customer rating, review count, prefecture, city, and photos pulled directly from CarSensor's own listing pages
• Deal-quality fields: vehicle inspection (shaken) expiry, accident history, warranty coverage, and included maintenance — details most listing scrapers don't expose
• Empty fields are omitted — every record only contains fields CarSensor actually populated for that vehicle

Output per listing

• listingId — CarSensor internal listing ID
• vehicleTitle — model, grade/trim, and the dealer's own marketing description
• make — populated when a maker filter was applied
• year — model/registration year
• priceJpy, priceManYen — total out-the-door price (JPY, and in units of 10,000 JPY as commonly quoted in Japan)
• priceOnRequest — true for the small number of listings (mostly ultra-high-end exotics) CarSensor marks "応談" (negotiable/price on request) instead of a fixed price; these have no priceJpy/priceManYen and are excluded automatically whenever a price filter is set
• mileageKm — odometer reading
• displacementCc — engine displacement
• fuelType — populated when a fuel-type filter was applied
• transmission
• bodyType — body style (SUV, sedan, hatchback, station wagon, minivan, etc.) as labeled on the listing card
• bodyColor
• inspectionExpiry — shaken (vehicle inspection) validity
• accidentHistory — repair/accident history disclosure
• warranty, maintenance — coverage included with the sale
• prefecture, city — dealer location
• dealerName, dealerRating, dealerReviewCount
• imageUrl
• listingUrl — canonical carsensor.net listing URL
• recordType: "usedCarListing", sourceSite: "carsensor.net", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byId
maker	string	any	Maker/brand (dropdown of ~45 makers, from Toyota to Ferrari); leave empty to search all makers nationwide
keyword	string	–	Free-text model/keyword search
fuelType	string	–	Gasoline / Diesel / Hybrid / Electric / Other
bodyType	string	–	Sedan / Wagon / Hatchback / SUV / Minivan / Coupe / Convertible / Pickup / Truck / Other
transmission	string	–	Automatic/CVT or Manual
color	string	–	Exterior color (White, Black, Silver, Blue, Red, etc.)
steering	string	–	Right-hand drive or left-hand drive
minPriceManYen / maxPriceManYen	int	–	Total price range, in units of ¥10,000
minYear / maxYear	int	–	Model-year range
minMileageKm / maxMileageKm	int	–	Odometer range
minDisplacementCc / maxDisplacementCc	int	–	Engine displacement range
excludeKeiCars	boolean	false	Filter out Japanese kei-class minicars (≤660cc) (mode=search only)
sortBy	string	recommended	recommended / price high-to-low / price low-to-high / model year newest-first / model year oldest-first (mode=search only). Note: carsensor.net's price sort orders by the base vehicle price, not the total out-the-door price returned as priceManYen, so results won't be perfectly monotonic by priceManYen when sorted by price.
listingIds	array	–	CarSensor listing IDs to look up (mode=byId)
maxItems	int	20	Max results (1–500)

Example: used Toyotas under ¥3,000,000 from 2018 onward

{
  "mode": "search",
  "maker": "TO",
  "maxPriceManYen": 300,
  "minYear": 2018,
  "maxItems": 30
}

Example: hybrid SUVs, any maker

{
  "mode": "search",
  "fuelType": "3",
  "bodyType": "X",
  "maxItems": 30
}

Example: look up specific listings by ID

{
  "mode": "byId",
  "listingIds": ["AU6977551094"]
}

Use cases

• Track used-car pricing trends in the Japanese market by maker/model
• Source export-ready used-vehicle inventory (JDM export, dealer sourcing)
• Compare hybrid/EV pricing across body styles and mileage bands
• Monitor dealer inventory and review scores for a specific brand
• Feed a price-estimation or valuation model with real listing data

FAQs

Do I need a CarSensor account or API key? No. This actor scrapes CarSensor's public listing pages directly.

What language is the data in? CarSensor is a Japanese-market site, so vehicleTitle, dealer names, and location fields are in Japanese. Numeric fields (priceJpy, year, mileageKm, etc.) are always plain numbers.

Why is make sometimes missing? make is only populated when you filter by a specific maker — CarSensor's nationwide search results don't label brand as a separate field per listing, so this actor never guesses it.

Can I search by model name? Yes — use the keyword field with a Japanese or partial model name (e.g. プリウス for Prius).

Does this actor support pagination beyond one page? Yes — set maxItems above the page size (~30) and the actor pages through results automatically.

What if a listing ID isn't found? If CarSensor has no active listing for that ID (sold or delisted), the actor skips it and logs a warning rather than emitting a fabricated record.