
Carsensor APIScraper & Parser
Carsensor API: цени при японски дилъри с и без разходи за регистрация, пробег, проверки, характеристики и снимки. Поток от промени, всички наличности ежедневно.
Carsensor API
Парсърът и скрейпърът за Carsensor работят при нас, а вие получавате готови за използване обяви на японски дилъри чрез API. Всеки запис съдържа цената на автомобила и общата цена при дилъра, пробега, техническите характеристики, данните от проверката и снимките, а потокът от промени ви съобщава за нови обяви, промени в цените и автомобили, свалени от продажба.
Потокът от промени съобщава за всяка нова обява в Carsensor, всяка промяна на цената и всяко сваляне от продажба.
Един файл на ден с всички налични в момента автомобили в Carsensor.
Цена на автомобила и обща цена при дилъра, година на регистрация, пробег, кодове на модела и двигателя, мощност, скоростна кутия, задвижване и разположение на волана, бележки за състоянието и ремонтите, лист от проверката, оборудване, дилър и снимки.
Базов URL
https://{access_name}.auto-api.com/api/v2/carsensorОторизация: api_key параметър
Ред на работа
/filtersполучаване на наличните стойности на филтрите/offersполучаване на обяви (с филтри или без) - използвайте за първоначално зареждане на даннитеЗа обновявания (за да поддържате данните актуални след първоначалното зареждане):
/change_id?date=...получаване на началното ID за потока от промени/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID/offerполучаване на данни за конкретна обява по inner_idОткъде да започнете:
1. Преди първото зареждане извикайте /change_id с днешната дата и запазете върнатото ID; ако върне 0, опитайте отново малко по-късно. След това изтеглете /offers страница по страница, чак до последната страница.
2. После четете /changes, като започнете от това ID и подавате next_change_id от всеки отговор: така получавате новопостъпилите автомобили, новите цени и премахнатите обяви. Ако next_change_id се върне като null, все още няма нови събития: повторете заявката по-късно със същото ID.
3. За да търсите по собствени критерии, извиквайте /offers с нужните ви филтри.
GET/filters
Връща всички възможни стойности за филтриране
https://{access_name}.auto-api.com/api/v2/carsensor/filters?api_key=YOUR_API_KEYОтговор:
{
"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
Списък с обяви със страниране и филтри
Параметри:
page(задължително) - номер на страницатаmark, model- марка и модел, изписани както във /filterstransmission_type, color, body_type, engine_type, drive_type, rudder- скоростна кутия, цвят, тип каросерия, гориво, задвижване и разположение на волана, без разлика между главни и малки буквиyear_from, year_to- диапазон от години на първа регистрацияkm_age_from, km_age_to- диапазон на пробега, кмprice_from, price_to- диапазон на цената на автомобила, йени
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=GasolineОтговор:
{
"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": "埼玉県幸手市北2-6-16",
"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 }
}Полета на записа
- id - номер на записа в нашата база данни; използвайте полето inner_id, за да го съпоставите с обявата в платформата
- inner_id - идентификатор на обявата в Carsensor, който е и част от URL адреса на обявата: AU7363661281
- url - връзка към обявата в carsensor.net
- title - заглавие на обявата, както го е написал дилърът
- section - раздел: used за употребявани автомобили, new за нови
- mark, model - марка и модел, напр. Honda и Freed
- generation - период, през който е произвеждана тази версия на модела, във формат 2017.04 - 2018.03; без крайна дата, ако моделът още се произвежда
- configuration - код на модела от японските регистрационни документи, напр. 5BA-GT1
- complectation - ниво на оборудване, както е посочено от дилъра
- year - година, в която автомобилът е регистриран за първи път; при паралелен внос платформата посочва годината на производство
- color - цвят на каросерията, стойности от /filters
- body_type - тип каросерия, стойности от /filters
- doors_count - брой врати
- engine_type - вид гориво, стойности от /filters
- displacement - обем на двигателя в куб. см
- horse_power - фабрична мощност в к.с.; при хибридите се отчита само двигателят с вътрешно горене, при електромобилите това е електромоторът; празно, когато няма данни
- transmission_type - тип скоростна кутия: автоматична, ръчна, CVT или друга
- drive_type - 4WD или 2WD; при 2WD полето drive_catalog показва кои колела са задвижващи
- rudder - разположение на волана
- price - цена на автомобила в йени, с включен японски данък върху потреблението, разходите за регистрация са отделно; -1, когато цената е при запитване
- km_age - пробег в километри, както го закръгля платформата, обикновено до 1 000 км; празно, когато пробегът е неизвестен или манипулиран
- no_accidents - true означава, че носещите елементи на каросерията не са ремонтирани или сменени; false означава, че е имало такъв ремонт или смяна
- condition - бележки на дилъра като списък, разделени със запетая, напр. един собственик, автомобил на непушач, сервизна документация
- owners_count - 1, когато дилърът е посочил един собственик, иначе празно
- equipment - списък с оборудване като JSON масив в низ
- seller - име на дилъра
- seller_url - връзка към профила на дилъра в carsensor.net
- salon_id - ID на дилъра в Carsensor
- region - префектура, в която се намира автомобилът
- city - град или район
- address - адрес на дилъра
- images - връзки към снимките като JSON масив в низ; много автомобили имат по няколко десетки снимки
- offer_created - дата на появяване на обявата според етикета NEW; празно, ако датата е неизвестна
- extra_prep - вложен обект с допълнителни данни, описан по-долу; липсващите стойности идват като null
В обекта extra_prep
- total_price - обща сума за плащане в йени: автомобилът плюс задължителните разходи за регистрация, когато купувате от този дилър и регистрирате автомобила в неговия район
- plan_prices - обща сума за плащане при пакетите A и B на дилъра, напр. с удължена гаранция; не всеки автомобил ги има
- is_price_ask - true, когато дилърът не е посочил цена и полето price е -1
- monthly_loan - месечна вноска по кредита за автомобил от дилъра, в йени
- monthly_loan_type - вид кредит: regular за стандартен кредит, residual за кредит с балонна вноска в края
- mileage_raw - пробег точно както е написан в обявата, включително бележките, ако има такива
- is_mileage_unknown - true, когато реалният пробег е неизвестен
- is_mileage_tampered - true, когато е потвърдено манипулиране на одометъра
- is_meter_replaced - true, когато одометърът е сменен
- year_raw - година от обявата заедно с означението на японската ера: 2025(R07)
- shaken - срок на валидност на японския технически преглед (година и месец) или бележка дали дилърът ще го уреди при продажбата
- warranty - дали има гаранция
- maintenance - задължително по закон сервизно обслужване преди продажба: включено в цената, прави се срещу доплащане или не се прави
- recycle_fee - статус на японската такса за рециклиране: дали е платена и дали е включена в цената
- transmission_raw - оригинално означение на скоростната кутия: разположение на скоростния лост, брой предавки и дали има ръчен режим
- color_name - цвят с думите на дилъра
- color_factory - фабрично име на цвета
- chassis_no_tail - последните три цифри от номера на шасито; Carsensor не публикува пълния номер
- seats - брой места
- fuel - препоръчано от производителя гориво: обикновен бензин, високооктанов бензин или дизел
- drive_catalog - задвижване според фабричните технически характеристики, напр. FF (предни колела), FR (задни колела) или 4WD (и четирите)
- power_kw - мощност от полето horse_power, преизчислена в kW
- power_kw_estimated - true, когато стойността в kW е преизчислена от к.с.
- engine_kind - конструкция на двигателя: брой и разположение на цилиндрите, тип на газоразпределителния механизъм; при електромобилите се посочва електромоторът
- engine_code - код на двигателя: L15D
- displacement_exact - обем на двигателя по фабрични данни, с точност до кубически сантиметър: 1496
- grade_name - пълно име на нивото на оборудване по фабрични данни
- catalog_path - идентификатор на нивото на оборудване в carsensor.net: той е еднакъв за автомобилите с едно и също ниво
- maker_code - вътрешен код на марката в Carsensor
- model_code_site - вътрешен код на модела в Carsensor
- is_new - true при етикет NEW: обявата се е появила или е публикувана отново през последната седмица
- labels - етикети на обявата, напр. гаранция от дилъра, 360° изглед, онлайн консултация, доклад от оценката
- is_maker_certified - true за автомобили, сертифицирани от производителя
- evaluation - резултат от проверката: кой е проверил автомобила, обща оценка и дата; оценка R получават автомобилите с ремонтирани носещи елементи на каросерията
- ais - подробен лист от проверката на Carsensor: обща оценка, буквени оценки за интериора и екстериора, код на модела, показание на одометъра в деня на проверката, дали е имало цялостно пребоядисване или смяна на одометъра, списък с дефекти и връзка към изображение с отбелязаните щети
GET/change_id
Получаване на първото ID на промяна по дата (за използване в /changes)
Параметри:
date(задължително) - дата във формат yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/carsensor/change_id?api_key=YOUR_API_KEY&date=2026-09-29Отговор:
{ "change_id": 1254 }Използвайте върнатата стойност като параметър change_id в /changes
GET/changes
Поток от промени (добавени/променени/премахнати)
Параметри:
change_id(задължително) - от кое ID на промяна да се започне
https://{access_name}.auto-api.com/api/v2/carsensor/changes?api_key=YOUR_API_KEY&change_id=1254Отговор:
{
"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
Една обява по inner_id
Параметри:
inner_id(задължително)
https://{access_name}.auto-api.com/api/v2/carsensor/offer?api_key=YOUR_API_KEY&inner_id=AU7363661281Отговор: обект data (същият като в /offers, но без обвивката result)
Съхранение
Файловете остават достъпни поне 3 дни
Достъпност
Нови файлове всяка сутрин
CSV формат
Колоните в CSV са разделени с вертикална черта (|)
Структура на URL адреса:
Параметри:
access_name- вашият личен поддомейнdate- дата на експорта във формат yyyy-mm-dd, напр. 2026-09-29file_name- име на файла с разширението
Налични файлове:
- 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
Примерна заявка с 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.csvПримерна команда с Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Carsensor (carsensor.net) е собственост на японската компания Recruit и е един от най-големите сайтове за употребявани автомобили в страната. Обяви публикуват само дилъри, от малки автокъщи до официални дилъри на марките, и там можете да намерите почти всичко, включително кей карове, камиони и кемпери.
Цените в Carsensor са в йени и идват като две суми: цена на автомобила и обща цена при дилъра, която включва разходите за регистрация. Обявата показва дали носещи елементи на каросерията са ремонтирани или сменени, дали има гаранция и през кой месец изтича техническият преглед (shaken). Някои автомобили се проверяват от инспектор на Carsensor и тогава обявата включва лист от проверката с оценки и дефекти.
За вносителя Carsensor е бърз начин да намери нужното ниво на оборудване при дилъри от цяла Япония, без да пропуска новите обяви. Същите данни показват колко струва даден модел на японския пазар и как се променя цената му, а по кода на модела и характеристиките на двигателя лесно се пресмятат предварително митата и таксите при внос.
Новите обяви, промените в цените и свалените от продажба автомобили пристигат чрез метода /changes. За това не ви трябва собствен парсър.
Разширете покритието на автомобилните си данни по световните пазари с нашите API за отделните платформи: