Carsensor APIScraper a parser
Carsensor API: cena vozu i celková cena s registrací u japonských dealerů, nájezd, prohlídky, parametry a fotky. Události ke každému vozu, celá nabídka denně.
Carsensor API
Parser a scraper Carsensor běží na naší straně a vy si přes API stahujete hotové inzeráty japonských dealerů. Záznam obsahuje cenu vozu a celkovou cenu u dealera, nájezd, technické údaje, výsledky prohlídky a fotografie. Feed změn hlásí nové inzeráty, nové ceny vozů a stažení z prodeje.
Feed změn hlásí každý nový inzerát na Carsensoru, novou cenu i stažení z prodeje.
Každý den soubor s celou aktuální nabídkou Carsensoru.
Cena vozu a celková cena u dealera, rok registrace, nájezd, kód modelu a motoru, výkon, převodovka, pohon a strana volantu, údaje o stavu a opravách, protokol z prohlídky, výbava, dealer a fotky.
Základní URL
https://{access_name}.auto-api.com/api/v2/carsensorAutorizace: api_key parametr
Pracovní postup
/filterszískat dostupné hodnoty filtrů/offerszískat inzeráty (s filtry nebo bez nich) - použít pro počáteční načtení datPro aktualizace (udržování dat aktuálních po počátečním načtení):
/change_id?date=...získat počáteční ID pro stream změn/changes?change_id=...získat všechny změny v databázi od daného ID/offerzískat detaily konkrétního inzerátu podle inner_idKde začít:
1. Před prvním načtením zavolejte /change_id s dnešním datem a uložte si odpověď; pokud vrátí nulu, zkuste to znovu o něco později. Potom stáhněte /offers stránku po stránce až do konce.
2. Poté čtěte /changes od tohoto ID a pokaždé předávejte next_change_id z odpovědi: tak k vám dorazí nové vozy, nové ceny a odstraněné inzeráty. Pokud next_change_id přijde jako null, nové události zatím nejsou: zopakujte požadavek později se stejným ID.
3. Pro vyhledávání podle vlastních kritérií volejte /offers s potřebnými filtry.
GET/filters
Vrací všechny možné hodnoty pro filtrování
https://{access_name}.auto-api.com/api/v2/carsensor/filters?api_key=YOUR_API_KEYOdpověď:
{
"mark": {
"Toyota": {
"model": ["Alphard", "Aqua", "Crown", "Harrier", "Hiace Van", "Land Cruiser Prado", "Noah", "Prius", "Sienta", "Voxy"]
},
"Honda": {
"model": ["Fit", "Freed", "N-BOX", "Vezel"]
}
},
"transmission_type": ["Automatic", "CVT", "Manual", "Other"],
"color": ["Black", "Blue", "Brown", "Gold", "Gray", "Green", "Navy", "Orange", "Other", "Pearl", "Pink", "Purple", "Red", "Silver", "White", "Yellow"],
"body_type": ["Bus", "Camper", "Convertible", "Coupe", "Hatchback", "Minivan", "Other", "Pickup truck", "SUV", "Sedan", "Station wagon", "Truck"],
"engine_type": ["Diesel", "Electric", "Gasoline", "Hybrid", "Plug-in hybrid"],
"drive_type": ["2WD", "4WD"],
"rudder": ["Left", "Right", "Unknown"]
}GET/offers
Seznam inzerátů s stránkováním a filtry
Parametry:
page(povinné) - číslo stránkymark, model- značka a model zapsané jako v /filterstransmission_type, color, body_type, engine_type, drive_type, rudder- převodovka, barva, typ karoserie, palivo, pohon a strana volantu, bez rozlišení velikosti písmenyear_from, year_to- rozsah roku první registracekm_age_from, km_age_to- rozsah nájezdu v kmprice_from, price_to- rozsah ceny vozu v jenech
https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1&mark=Honda&model=Freed&year_from=2020&km_age_to=50000&engine_type=GasolineOdpověď:
{
"result": [
{
"id": 3,
"inner_id": "AU7363661281",
"change_type": "added",
"created_at": "2026-09-29T01:24:02.000+03:00",
"data": {
"id": "3",
"inner_id": "AU7363661281",
"url": "https://www.carsensor.net/usedcar/detail/AU7363661281/index.html",
"mark": "Honda",
"model": "Freed",
"generation": "2025.07 -",
"configuration": "5BA-GT1",
"complectation": "1.5 エアー EX",
"year": "2025",
"price": "3090000",
"km_age": "9000",
"color": "Navy",
"engine_type": "Gasoline",
"body_type": "Minivan",
"transmission_type": "CVT",
"drive_type": "2WD",
"rudder": "Right",
"displacement": "1500",
"doors_count": "5",
"horse_power": "118",
"condition": "Non-smoking car",
"no_accidents": true,
"owners_count": "",
"equipment": "[\"Power steering\", \"ABS\", \"Automatic emergency braking\", \"Adaptive cruise control\", \"Lane keeping assist\", \"Camera: rear\", \"Electronic stability control\"]",
"region": "Saitama",
"city": "幸手市",
"address": "埼玉県幸手市北２－６－１６",
"seller": "ネクステージ 幸手店",
"seller_url": "https://www.carsensor.net/shop/saitama/206339416/",
"salon_id": "206339416",
"section": "used",
"title": "フリード 1.5 エアー EX 両側電動スライドドア 純正11.4型ナビ バックカメラ 衝突軽減",
"offer_created": "2026-09-28",
"images": "[\"https://ccsrpcma.carsensor.net/CSphoto/bkkn/308/423/UZ0054308423/UZ0054308423_001.JPG?ver=detail001&impolicy=car_002\", \"https://ccsrpcml.carsensor.net/CSphoto/ml/308/423/UZ0054308423/UZ0054308423_1_001.jpg?ver=detail001&impolicy=car_002\"]",
"extra_prep": {
"total_price": 3212000,
"plan_prices": { "A": 3228000, "B": 3229000 },
"is_price_ask": false,
"monthly_loan": 25600,
"monthly_loan_type": "regular",
"is_mileage_unknown": false,
"is_mileage_tampered": false,
"is_meter_replaced": false,
"year_raw": "2025(R07)",
"chassis_no_tail": "064",
"seats": 6,
"power_kw": 86.79,
"power_kw_estimated": true,
"engine_code": "L15D",
"displacement_exact": 1496,
"catalog_path": "honda/freed/F003/M003G013",
"maker_code": "HO",
"model_code_site": "S083",
"is_new": true,
"is_maker_certified": false
// ... other extra_prep fields, including the ais inspection sheet
}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Pole záznamu
- id - číslo záznamu v naší databázi; pro propojení s inzerátem na platformě použijte inner_id
- inner_id - identifikátor inzerátu na Carsensoru, obsažený i v URL inzerátu: AU7363661281
- url - odkaz na inzerát na carsensor.net
- title - nadpis inzerátu, jak ho napsal dealer
- section - sekce: used pro ojeté vozy, new pro nové
- mark, model - značka a model, například Honda a Freed
- generation - období výroby této verze modelu ve formátu 2017.04 - 2018.03; pokud se model stále vyrábí, koncové datum chybí
- configuration - typové označení modelu z japonských registračních dokladů, například 5BA-GT1
- complectation - výbavová verze uvedená dealerem
- year - rok první registrace vozu; u vozů z paralelního dovozu platforma uvádí rok výroby
- color - barva karoserie, hodnoty z /filters
- body_type - typ karoserie, hodnoty z /filters
- doors_count - počet dveří
- engine_type - typ paliva, hodnoty z /filters
- displacement - zdvihový objem motoru, cm³
- horse_power - výkon podle výrobce v koních; u hybridu se počítá jen spalovací motor, u elektromobilu je uveden elektromotor; když údaj chybí, pole je prázdné
- transmission_type - typ převodovky: automat, manuál, variátor nebo jiná
- drive_type - 4WD nebo 2WD; která kola jsou u 2WD hnaná, ukazuje drive_catalog
- rudder - strana volantu
- price - cena vozu v jenech, japonská spotřební daň je už zahrnuta, náklady na registraci se počítají zvlášť; -1, když je cena na dotaz
- km_age - nájezd v kilometrech tak, jak ho zaokrouhluje platforma, obvykle na tisíce; při neznámém nebo stočeném nájezdu je pole prázdné
- no_accidents - true znamená, že nosná struktura karoserie nebyla opravována ani měněna; false, že takové práce proběhly
- condition - poznámky dealera jako seznam oddělený čárkami, například jeden majitel, nekuřácký interiér, servisní knížka
- owners_count - 1, pokud dealer uvedl jediného majitele; jinak prázdné
- equipment - seznam výbavy jako pole JSON v řetězci
- seller - název dealera
- seller_url - odkaz na profil dealera na carsensor.net
- salon_id - identifikátor dealera na Carsensoru
- region - prefektura, kde vůz stojí
- city - město nebo obvod
- address - adresa dealera
- images - odkazy na fotky jako pole JSON v řetězci, u mnoha vozů několik desítek snímků
- offer_created - datum objevení inzerátu podle označení NEW; prázdné, pokud datum není známé
- extra_prep - vnořený objekt s dalšími daty, popsaný níže; když hodnota chybí, přichází null
Uvnitř extra_prep
- total_price - celkem k úhradě v jenech: vůz plus povinné poplatky za registraci při koupi u tohoto dealera a přihlášení vozu v regionu dealera
- plan_prices - celkem k úhradě u balíčků A a B od dealera, například s prodlouženou zárukou; jen u některých vozů
- is_price_ask - true, když dealer neuvedl cenu a price je -1
- monthly_loan - výše měsíční splátky úvěru od dealera v jenech
- monthly_loan_type - typ úvěru: regular pro běžný úvěr, residual pro úvěr se zůstatkovou splátkou na konci
- mileage_raw - nájezd tak, jak je uveden v inzerátu, včetně poznámek
- is_mileage_unknown - true, když skutečný nájezd není znám
- is_mileage_tampered - true, když je potvrzeno stočení tachometru
- is_meter_replaced - true, když byl tachometr vyměněn
- year_raw - rok z inzerátu včetně označení japonské éry: 2025(R07)
- shaken - platnost japonské technické kontroly (rok a měsíc) nebo poznámka, zda ji dealer při prodeji zajistí
- warranty - zda má vůz záruku
- maintenance - povinný servis před prodejem: zahrnutý v ceně, za příplatek nebo se neprovádí
- recycle_fee - stav japonského recyklačního poplatku: zda je zaplacený a zda je zahrnutý v ceně
- transmission_raw - původní označení převodovky: umístění voliče, počet převodových stupňů a zda má manuální režim
- color_name - barva slovy dealera
- color_factory - tovární název barvy
- chassis_no_tail - poslední tři číslice čísla karoserie; celé číslo Carsensor nezveřejňuje
- seats - počet míst
- fuel - palivo doporučené výrobcem: běžný benzin, vysokooktanový benzin nebo nafta
- drive_catalog - typ pohonu podle tovární specifikace, například FF (přední kola), FR (zadní) nebo 4WD (všechna čtyři)
- power_kw - výkon z horse_power přepočtený na kW
- power_kw_estimated - true, když byla hodnota v kW přepočtena z koní
- engine_kind - konstrukce motoru: počet a uspořádání válců, typ rozvodu; u elektromobilu elektromotor
- engine_code - kód motoru: L15D
- displacement_exact - objem motoru podle údajů výrobce s přesností na kubický centimetr: 1496
- grade_name - úplný název výbavové verze podle údajů výrobce
- catalog_path - identifikátor výbavové verze na carsensor.net: vozy se stejnou výbavovou verzí ho mají shodný
- maker_code - interní označení značky na Carsensoru
- model_code_site - interní označení modelu na Carsensoru
- is_new - true při označení NEW: inzerát se objevil nebo byl znovu zveřejněn během posledního týdne
- labels - štítky u inzerátu, například záruka dealera, záběry 360°, online konzultace, zpráva o hodnocení
- is_maker_certified - true u vozů s certifikací výrobce
- evaluation - výsledek kontroly hodnotitelem: kdo kontroloval, celkové hodnocení a datum; hodnocení R dostávají vozy s opravovanou nosnou strukturou karoserie
- ais - podrobný protokol z prohlídky od Carsensoru: celkové hodnocení, písmenné hodnocení interiéru a exteriéru, kód modelu, stav tachometru v den kontroly, zda proběhlo kompletní přelakování a výměna tachometru, seznam vad a odkaz na obrázek s vyznačeným poškozením
GET/change_id
Získat první ID změny podle data (pro použití v /changes)
Parametry:
date(povinné) - datum ve formátu yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/carsensor/change_id?api_key=YOUR_API_KEY&date=2026-09-29Odpověď:
{ "change_id": 1254 }Použijte vrácenou hodnotu jako parametr change_id v /changes
GET/changes
Stream změn (přidáno/změněno/odstraněno)
Parametry:
change_id(povinné) - od kterého ID změny
https://{access_name}.auto-api.com/api/v2/carsensor/changes?api_key=YOUR_API_KEY&change_id=1254Odpověď:
{
"result": [
{
"id": 1254,
"inner_id": "AU7305608350",
"change_type": "added", // added - new listing
"created_at": "2026-09-29T19:12:40.512+03:00",
"data": { ... } // full listing data
},
{
"id": 1255,
"inner_id": "AU7363661281",
"change_type": "changed", // changed - new car price, JPY
"created_at": "2026-09-29T20:05:17.208+03:00",
"data": { "new_price": 2990000 }
},
{
"id": 1256,
"inner_id": "AU6927774389",
"change_type": "removed", // removed - listing deleted
"created_at": "2026-09-29T21:48:02.331+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 1254, "next_change_id": 1257, "limit": 20 }
}GET/offer
Jednotlivý inzerát podle inner_id
Parametry:
inner_id(povinné)
https://{access_name}.auto-api.com/api/v2/carsensor/offer?api_key=YOUR_API_KEY&inner_id=AU7363661281Odpověď: objekt data (stejný jako v /offers, ale bez wrapperu result)
Uchování
Soubory zůstávají dostupné nejméně 3 dny
Dostupnost
Nové soubory každé ráno
Formát CSV
Sloupce CSV jsou odděleny znakem svislítko (|)
Struktura URL:
Parametry:
access_name- vaše osobní subdoménadate- datum exportu ve formátu rrrr-mm-dd, např. 2026-09-29file_name- název souboru s příponou
Dostupné soubory:
- CSV - all_active.csv, new_daily.csv, removed_daily.csv
- JSON - all_active.json, new_daily.json, removed_daily.json
- Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx
Příklad požadavku cURL
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvPříklad příkazu Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Carsensor (carsensor.net) patří japonské společnosti Recruit a je jedním z největších webů s ojetými auty v Japonsku. Inzeráty zveřejňují jen dealeři, od malých autobazarů po značkové autosalony, a prodává se tu téměř všechno včetně kei carů, nákladních aut a obytných vozů.
Carsensor uvádí ceny v jenech, zvlášť cenu vozu a celkovou cenu s registrací u dealera. Z inzerátu je vidět, zda se opravovaly nebo měnily nosné části karoserie, zda má vůz záruku a do kterého měsíce platí technická kontrola. Část vozů prochází prohlídkou u hodnotitele Carsensoru a k inzerátu se pak přikládá protokol s bodovým hodnocením a seznamem vad.
Dovozci tu rychle najdou potřebnou výbavovou verzi u dealerů z celého Japonska a nepropásnou čerstvé inzeráty. Ze stejných dat je vidět, kolik model na japonském trhu stojí a jak se mění jeho cena. Podle kódu modelu a parametrů motoru se dají předem snadno odhadnout náklady na clo a dovozní poplatky.
Přes /changes přicházejí nové inzeráty, nové ceny vozů a stažení z prodeje. Vlastní parser k tomu nepotřebujete.
Automobilová data z různých světových trhů s našimi platformovými API: