AUTO-API.COM
Logo Carsensor

Carsensor APIScraper i parser

Carsensor API: cena auta i łączna kwota u japońskiego dealera, przebieg, oględziny, parametry i zdjęcia. Zdarzenia dla każdego auta, pełny eksport co dobę.

Oficjalne biblioteki SDK

Metody API są dostępne w naszych SDK jako gotowe funkcje, a otwarty kod bibliotek znajdziesz na GitHubie.

Carsensor API

Parser i scraper Carsensor działają po naszej stronie, a gotowe oferty japońskich dealerów pobierasz przez API. Rekord zawiera cenę auta i łączną kwotę u dealera, przebieg, dane techniczne, wyniki oględzin i zdjęcia, a strumień zmian informuje o nowych ofertach, nowej cenie auta i wycofaniu ze sprzedaży.

API

Strumień zmian informuje o każdej nowej ofercie Carsensor, nowej cenie i wycofaniu ze sprzedaży.

Codzienne eksporty

Codziennie plik ze wszystkimi aktualnymi ofertami Carsensor.

Pełne dane

Cena auta i łączna kwota u dealera, rok rejestracji, przebieg, kod modelu i silnika, moc, skrzynia biegów, napęd i strona kierownicy, informacje o stanie i naprawach, raport z oględzin, wyposażenie, dealer i zdjęcia.

Uzyskaj dostęp do APIDostęp przyznany w ciągu 2 minut

Bazowy URL

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

Autoryzacja: api_key parametr

Schemat integracji

1
/filterspobierz dostępne wartości filtrów
2
/offerspobierz ogłoszenia (z filtrami lub bez) - użyj do początkowego ładowania danych
3

Dla aktualizacji (utrzymanie aktualności danych po początkowym ładowaniu):

/change_id?date=...pobierz początkowe ID dla strumienia zmian
/changes?change_id=...pobierz wszystkie zmiany w bazie danych od podanego ID
4
/offerpobierz szczegóły konkretnego ogłoszenia według inner_id

Od czego zacząć:

1. Przed pierwszym pobraniem wywołaj /change_id z bieżącą datą i zapisz odpowiedź; jeśli w odpowiedzi jest zero, powtórz żądanie nieco później. Następnie pobierz /offers strona po stronie aż do końca.

2. Potem odczytuj /changes od tego ID, za każdym razem przekazując next_change_id z odpowiedzi: tak dostaniesz nowe auta, nowe ceny i usunięte oferty. Jeśli next_change_id ma wartość null, nowych zdarzeń jeszcze nie ma: powtórz żądanie później z tym samym ID.

3. Aby wyszukiwać według własnych kryteriów, wywołuj /offers z potrzebnymi filtrami.

GET/filters

Zwraca wszystkie możliwe wartości do filtrowania

https://{access_name}.auto-api.com/api/v2/carsensor/filters?api_key=YOUR_API_KEY

Odpowiedź:

{
  "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

Lista ogłoszeń z paginacją i filtrami

Parametry:

  • page (wymagane) - numer strony
  • mark, model - marka i model w pisowni z /filters
  • transmission_type, color, body_type, engine_type, drive_type, rudder - skrzynia biegów, kolor, typ nadwozia, paliwo, napęd i strona kierownicy, bez rozróżniania wielkości liter
  • year_from, year_to - zakres roku pierwszej rejestracji
  • km_age_from, km_age_to - zakres przebiegu w kilometrach
  • price_from, price_to - zakres ceny auta w jenach
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

Odpowiedź:

{
  "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 }
}

Pola rekordu

  • id - numer rekordu w naszej bazie; do powiązania z ofertą na platformie używaj inner_id
  • inner_id - identyfikator oferty na Carsensor, obecny też w adresie ogłoszenia: AU7363661281
  • url - link do ogłoszenia na carsensor.net
  • title - tytuł ogłoszenia napisany przez dealera
  • section - sekcja: used dla aut używanych, new dla nowych
  • mark, model - marka i model, np. Honda i Freed
  • generation - lata produkcji tej wersji modelu w formacie 2017.04 - 2018.03; jeśli model jest nadal produkowany, daty końcowej nie ma
  • configuration - oznaczenie modelu z japońskich dokumentów rejestracyjnych, np. 5BA-GT1
  • complectation - wersja wyposażenia podana przez dealera
  • year - rok pierwszej rejestracji auta; przy imporcie równoległym platforma podaje rok produkcji
  • color - kolor nadwozia, wartości z /filters
  • body_type - typ nadwozia, wartości z /filters
  • doors_count - liczba drzwi
  • engine_type - rodzaj paliwa, wartości z /filters
  • displacement - pojemność skokowa silnika, cm³
  • horse_power - fabryczna moc w KM; w hybrydzie uwzględniony jest tylko silnik spalinowy, w aucie elektrycznym podana jest moc silnika elektrycznego; bez danych pole jest puste
  • transmission_type - typ skrzyni biegów: automatyczna, manualna, bezstopniowa lub inna
  • drive_type - 4WD lub 2WD; które koła są napędzane w 2WD, widać w drive_catalog
  • rudder - strona kierownicy
  • price - cena auta w jenach, japoński podatek konsumpcyjny jest już wliczony, koszty rejestracji liczone są osobno; przy cenie na zapytanie -1
  • km_age - przebieg w kilometrach zaokrąglony przez platformę, zwykle do tysięcy; przy nieznanym lub cofniętym przebiegu pole jest puste
  • no_accidents - true oznacza, że konstrukcji nośnej nadwozia nie naprawiano ani nie wymieniano; false, że takie prace były wykonywane
  • condition - uwagi dealera jako lista rozdzielona przecinkami, np. jeden właściciel, w aucie nie palono, książka serwisowa
  • owners_count - wynosi 1, jeśli dealer podał, że auto miało jednego właściciela; w pozostałych przypadkach puste
  • equipment - lista wyposażenia jako tablica JSON w ciągu znaków
  • seller - nazwa dealera
  • seller_url - link do profilu dealera na carsensor.net
  • salon_id - identyfikator dealera w Carsensor
  • region - prefektura, w której stoi auto
  • city - miasto lub dzielnica
  • address - adres dealera
  • images - linki do zdjęć jako tablica JSON w ciągu znaków, przy wielu autach kilkadziesiąt ujęć
  • offer_created - data pojawienia się oferty według oznaczenia NEW; puste, jeśli data nie jest znana
  • extra_prep - zagnieżdżony obiekt z dodatkowymi danymi, opisany niżej; gdy wartości brak, przychodzi null

Zawartość extra_prep

  • total_price - łączna kwota do zapłaty w jenach: auto plus obowiązkowe koszty rejestracji przy zakupie u tego dealera i zarejestrowaniu auta w jego regionie
  • plan_prices - łączne kwoty do zapłaty w pakietach dealera A i B, np. z rozszerzoną gwarancją; nie wszystkie auta je mają
  • is_price_ask - true, gdy dealer nie podał ceny i price wynosi -1
  • monthly_loan - wysokość miesięcznej raty kredytu u dealera w jenach
  • monthly_loan_type - rodzaj kredytu: regular dla zwykłego kredytu, residual dla kredytu z ratą balonową na końcu
  • mileage_raw - przebieg zapisany tak jak w ogłoszeniu, razem z adnotacjami
  • is_mileage_unknown - true, gdy rzeczywisty przebieg jest nieznany
  • is_mileage_tampered - true, gdy potwierdzono cofnięcie licznika
  • is_meter_replaced - true, gdy licznik był wymieniany
  • year_raw - rok z ogłoszenia razem z oznaczeniem japońskiej ery: 2025(R07)
  • shaken - ważność japońskiego przeglądu technicznego (rok i miesiąc) albo adnotacja, czy dealer zapewni przegląd przy sprzedaży
  • warranty - czy auto ma gwarancję
  • maintenance - obowiązkowy serwis przed sprzedażą: wliczony w cenę, płatny osobno albo niewykonywany
  • recycle_fee - status japońskiej opłaty recyklingowej: czy została uiszczona i czy jest wliczona w cenę
  • transmission_raw - oryginalne oznaczenie skrzyni biegów: gdzie jest wybierak, ile jest biegów i czy jest tryb manualny
  • color_name - kolor opisany słowami dealera
  • color_factory - fabryczna nazwa koloru
  • chassis_no_tail - trzy ostatnie cyfry numeru nadwozia; pełnego numeru Carsensor nie publikuje
  • seats - liczba miejsc
  • fuel - paliwo zalecane przez producenta: zwykła benzyna, benzyna wysokooktanowa lub olej napędowy
  • drive_catalog - typ napędu według specyfikacji fabrycznej, np. FF (przednie koła), FR (tylne) lub 4WD (wszystkie cztery)
  • power_kw - moc z horse_power przeliczona na kW
  • power_kw_estimated - true, jeśli kW przeliczono z KM
  • engine_kind - budowa silnika: liczba i układ cylindrów, typ rozrządu; w aucie elektrycznym silnik elektryczny
  • engine_code - kod silnika: L15D
  • displacement_exact - pojemność silnika według danych fabrycznych z dokładnością do centymetra sześciennego: 1496
  • grade_name - pełna nazwa wersji wyposażenia według danych fabrycznych
  • catalog_path - identyfikator wersji wyposażenia na carsensor.net: auta w tej samej wersji mają ten sam identyfikator
  • maker_code - wewnętrzne oznaczenie marki w Carsensor
  • model_code_site - wewnętrzne oznaczenie modelu w Carsensor
  • is_new - true przy oznaczeniu NEW: oferta pojawiła się lub została wystawiona ponownie w ciągu ostatnich 7 dni
  • labels - etykiety w ogłoszeniu, np. gwarancja dealera, zdjęcia 360°, konsultacja online, raport z oceny stanu
  • is_maker_certified - true dla aut z certyfikatem producenta
  • evaluation - wynik oględzin rzeczoznawcy: kto sprawdzał auto, ocena ogólna i data; ocenę R dostają auta, w których naprawiano konstrukcję nośną nadwozia
  • ais - szczegółowy raport z oględzin od Carsensor: ocena końcowa, oceny literowe wnętrza i nadwozia, kod modelu, stan licznika w dniu oględzin, czy auto było w całości przemalowane i czy wymieniano licznik, lista usterek i link do schematu z zaznaczonymi uszkodzeniami

GET/change_id

Pobierz pierwsze ID zmiany według daty (do użycia w /changes)

Parametry:

  • date (wymagane) - data w formacie yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/carsensor/change_id?api_key=YOUR_API_KEY&date=2026-09-29

Odpowiedź:

{ "change_id": 1254 }

Użyj zwróconej wartości jako parametru change_id w /changes

GET/changes

Strumień zmian (dodano/zmieniono/usunięto)

Parametry:

  • change_id (wymagane) - od którego ID zmiany
https://{access_name}.auto-api.com/api/v2/carsensor/changes?api_key=YOUR_API_KEY&change_id=1254

Odpowiedź:

{
  "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

Pojedyncze ogłoszenie według inner_id

Parametry:

  • inner_id (wymagane)
https://{access_name}.auto-api.com/api/v2/carsensor/offer?api_key=YOUR_API_KEY&inner_id=AU7363661281

Odpowiedź: obiekt data (taki sam jak w /offers, ale bez wrappera result)

Przechowywanie

Pliki pozostają dostępne przez co najmniej 3 dni

Dostępność

Świeże pliki każdego ranka

Format CSV

Kolumny CSV są rozdzielone znakiem pipe (|)

Struktura URL:

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

Parametry:

  • access_name - Twoja osobista subdomena
  • date - data eksportu w formacie rrrr-mm-dd, np. 2026-09-29
  • file_name - nazwa pliku z rozszerzeniem

Dostępne pliki:

  • 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

Przykład żądania 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

Przykład polecenia Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Carsensor

Carsensor (carsensor.net) należy do japońskiej firmy Recruit i jest jednym z największych serwisów z używanymi autami w Japonii. Ogłoszenia zamieszczają wyłącznie dealerzy, od małych komisów po autoryzowane salony marek, a sprzedaje się tam niemal wszystko, także kei cary, ciężarówki i kampery.

Ceny w serwisie Carsensor podawane są w jenach: osobno cena auta i łączna kwota z kosztami rejestracji u dealera. Z ogłoszenia widać, czy elementy nośne nadwozia były naprawiane lub wymieniane, czy auto ma gwarancję i do którego miesiąca ważny jest przegląd techniczny. Część aut przechodzi oględziny u rzeczoznawcy Carsensor i wtedy do ogłoszenia dołączany jest raport z ocenami punktowymi i listą usterek.

Dla importera to sposób, by szybko znaleźć potrzebną wersję wyposażenia u dealerów w całej Japonii i nie przegapić świeżych ofert. Te same dane pokazują, ile model kosztuje na rynku japońskim i jak zmienia się jego cena, a na podstawie kodu modelu i parametrów silnika łatwo z góry oszacować cło i opłaty importowe.

Przez /changes przychodzą nowe oferty, nowe ceny aut i wycofania ze sprzedaży. Własny parser nie jest do tego potrzebny.

Odpowiedź w 2 min