AUTO-API.COM
Лого на Carsensor

Carsensor APIScraper & Parser

Carsensor API: цени при японски дилъри с и без разходи за регистрация, пробег, проверки, характеристики и снимки. Поток от промени, всички наличности ежедневно.

Официални SDK библиотеки

Нашите SDK библиотеки включват методите на API-то като готови функции, а самите библиотеки са с отворен код в GitHub.

Carsensor API

Парсърът и скрейпърът за Carsensor работят при нас, а вие получавате готови за използване обяви на японски дилъри чрез API. Всеки запис съдържа цената на автомобила и общата цена при дилъра, пробега, техническите характеристики, данните от проверката и снимките, а потокът от промени ви съобщава за нови обяви, промени в цените и автомобили, свалени от продажба.

API

Потокът от промени съобщава за всяка нова обява в Carsensor, всяка промяна на цената и всяко сваляне от продажба.

Ежедневни експорти

Един файл на ден с всички налични в момента автомобили в Carsensor.

Пълни данни

Цена на автомобила и обща цена при дилъра, година на регистрация, пробег, кодове на модела и двигателя, мощност, скоростна кутия, задвижване и разположение на волана, бележки за състоянието и ремонтите, лист от проверката, оборудване, дилър и снимки.

Получете достъп до APIДостъпът се предоставя до 2 минути

Базов URL

https://{access_name}.auto-api.com/api/v2/carsensor

Оторизация: api_key параметър

Ред на работа

1
/filtersполучаване на наличните стойности на филтрите
2
/offersполучаване на обяви (с филтри или без) - използвайте за първоначално зареждане на данните
3

За обновявания (за да поддържате данните актуални след първоначалното зареждане):

/change_id?date=...получаване на началното ID за потока от промени
/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID
4
/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 - марка и модел, изписани както във /filters
  • transmission_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 адреса:

https://{access_name}.auto-api.com/{date}/{file_name}

Параметри:

  • access_name - вашият личен поддомейн
  • date - дата на експорта във формат yyyy-mm-dd, напр. 2026-09-29
  • file_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 (carsensor.net) е собственост на японската компания Recruit и е един от най-големите сайтове за употребявани автомобили в страната. Обяви публикуват само дилъри, от малки автокъщи до официални дилъри на марките, и там можете да намерите почти всичко, включително кей карове, камиони и кемпери.

Цените в Carsensor са в йени и идват като две суми: цена на автомобила и обща цена при дилъра, която включва разходите за регистрация. Обявата показва дали носещи елементи на каросерията са ремонтирани или сменени, дали има гаранция и през кой месец изтича техническият преглед (shaken). Някои автомобили се проверяват от инспектор на Carsensor и тогава обявата включва лист от проверката с оценки и дефекти.

За вносителя Carsensor е бърз начин да намери нужното ниво на оборудване при дилъри от цяла Япония, без да пропуска новите обяви. Същите данни показват колко струва даден модел на японския пазар и как се променя цената му, а по кода на модела и характеристиките на двигателя лесно се пресмятат предварително митата и таксите при внос.

Новите обяви, промените в цените и свалените от продажба автомобили пристигат чрез метода /changes. За това не ви трябва собствен парсър.

Отговор до 2 мин