Dokumentacja | AUTO-API.COM

Dokumentacja API scrapera motoryzacyjnego. Dostęp do danych samochodowych przez endpointy API. Przewodniki integracji i przykłady kodu.

Czyste, ustrukturyzowane dane motoryzacyjne przez API. Bez skomplikowanej konfiguracji, zarządzania infrastrukturą czy utrzymania technicznego.

Dlaczego My

Doświadczenie Branżowe

Dostawca API danych motoryzacyjnych z ponad 8-letnim doświadczeniem od 2017 roku.

Wsparcie 7 Dni

Zespół wsparcia dostępny 7 dni w tygodniu do pomocy w integracji API.

Usługa 24/7

Ciągłe monitorowanie przez całą dobę dla niezawodnego dostarczania danych.

Kluczowe Możliwości API

Powiadomienia o Ogłoszeniach w Czasie Rzeczywistym

Natychmiastowy dostęp przez API do nowych ogłoszeń samochodowych po publikacji.

Codzienne Eksporty Danych

Codzienne eksporty aktywnych i wycofanych ogłoszeń do analizy rynku i śledzenia sprzedaży.

Elastyczne Formaty Eksportu

Dane w formatach CSV, JSON, Excel i niestandardowych dla łatwej integracji.

Często Zadawane Pytania

Jak działa API motoryzacyjne?

API motoryzacyjne zapewnia dostęp w czasie rzeczywistym do danych z wiodących portali samochodowych. Dostarcza ustrukturyzowane dane przez REST API do natychmiastowej analizy.

Jakie zbiory danych zapewnia API motoryzacyjne?

Uzyskaj kompletne dane samochodowe, w tym specyfikacje, ceny, informacje o sprzedawcy, lokalizację i przebieg. Dostęp do milionów ogłoszeń z głównych platform przez wywołania API.

Czy istnieją limity użytkowania dla API motoryzacyjnego?

Brak limitów użytkowania, z ograniczeniem liczby zapytań dla stabilnej wydajności. Uzyskaj wszystkie aktywne ogłoszenia w regionach przez API czasu rzeczywistego lub codzienne eksporty. Brak ograniczeń dla partnerów korporacyjnych.

Jak mogę śledzić nowe ogłoszenia samochodowe za pomocą API czasu rzeczywistego?

Monitoruj ogłoszenia za pomocą parametru 'from_id'. Zacznij od from_id=0, następnie użyj ID ostatniej zmiany + 1. Przechwytuje to nowe ogłoszenia, zmiany cen i wycofania na platformach.

Jakie formaty danych obsługujecie?

Otrzymuj dane w formatach CSV, JSON, Excel i bazach danych. Wszystkie formaty zawierają kompletne dane ze wszystkich platform.

Czy możecie zapewnić niestandardowy dostęp API do konkretnego portalu?

Tak, budujemy niestandardowe rozwiązania API dla dowolnego portalu samochodowego. Uzyskaj dostosowany dostęp do danych dla swoich specyficznych potrzeb. Skontaktuj się z nami w sprawie wymagań.

Czy moje wykorzystanie danych i współpraca są poufne?

Tak. Pracujemy na podstawie ścisłych umów o poufności ze wszystkimi klientami. Twoje wykorzystanie naszych usług danych samochodowych pozostaje całkowicie prywatne i bezpieczne.

Czy muszę zarządzać jakąkolwiek infrastrukturą lub serwerami?

Nie, usługa jest w pełni zarządzana. Zajmujemy się całą infrastrukturą, serwerami i zbieraniem danych. Uzyskujesz gotowe do użycia dane bez konieczności konfiguracji technicznej.

Dostępne Pola Danych

Nasze API daje dostęp do kompletnych punktów danych, w tym:

Podstawowe Atrybuty Pojazdu

  • Marka i Model
  • Rok i Generacja
  • Wersja i Konfiguracja
  • Typ Nadwozia
  • Kolor Zewnętrzny

Specyfikacje Techniczne

  • Typ Silnika i Pojemność
  • Moc
  • Skrzynia Biegów
  • Napęd
  • Stan Licznika

Dane Ogłoszenia na Portalu

  • Cena i Waluta
  • URL Ogłoszenia i ID
  • Dostępność
  • Data Publikacji
  • Pełny Opis

Szczegóły Sprzedawcy i Lokalizacji

  • Region i Miasto
  • Typ Sprzedawcy (Dealer/Prywatny)
  • Informacje Kontaktowe
  • Historia Pojazdu
  • Zdjęcia i Opcje

* Dostępność pól danych różni się w zależności od portalu źródłowego i kompletności ogłoszenia.

Codzienne Eksporty Danych

Przechowywanie Danych

Pliki eksportów są utrzymywane z bezpiecznym, co najmniej 3-dniowym przechowywaniem oraz zautomatyzowanym systemem archiwizacji.

Dostępność Eksportów

Codzienne eksporty danych z zaktualizowaną zawartością są dostępne do pobrania każdego dnia

Szczegóły Formatu CSV

Pliki CSV używają znaku pionowej kreski (|) jako standardowego separatora kolumn we wszystkich zbiorach danych.

Struktura URL:

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

Parametry Żądania:

  • personal_name - Twój unikalny, przypisany identyfikator subdomeny.
  • date - data docelowa dla danych w formacie RRRR-MM-DD (np. 2025-09-06).
  • file_name - nazwa pliku eksportu, wraz z rozszerzeniem.

Dostępne Formaty:

  • CSV - CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

Przykład Żądania API cURL

curl -L -X GET 'https://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

Przykład pobrania przez Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Dokumentacja API Czasu Rzeczywistego

Parametry Żądania API

api_key - Twój unikalny klucz API do uwierzytelniania.

from_id - ID Zmiany, od którego należy pobierać dane. Użyj 0 dla początkowego żądania, następnie ID ostatniej otrzymanej + 1.

Pola Odpowiedzi API

inner_id - Stałe, unikalne ID ogłoszenia na portalu źródłowym.

change_type - Typ zdarzenia: "added", "changed" (np. aktualizacja ceny) lub "removed".

created_at - Znacznik czasu wskazujący, kiedy nastąpiło zdarzenie.

Przykład Treści Odpowiedzi

{
  "result": [
    {
      "id": 2664810,
      "inner_id": "40428521",
      "change_type": "added",
      "created_at": "2025-09-02T05:44:49.000",
      "data": {
        "id": "1455502",
        "inner_id": "40428521",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40428521",
        "mark": "Hyundai",
        "model": "Genesis",
        "generation": "200 Turbo S",
        "configuration": "200 Turbo S",
        "complectation": null,
        "year": "2012",
        "color": "Red",
        "price": "8900000",
        "km_age": "246400",
        "engine_type": "Gasoline",
        "transmission_type": "Manual",
        "body_type": "Sports Car",
        "address": "Busan Dongnae-gu",
        "seller_type": "REPEAT",
        "is_dealer": "false",
        "section": "used",
        "seller": "cainabel",
        "salon_id": "05062013358",
        "description": "I'm not a dealer; I'm an individual who loves cars...",
        "displacement": "1998.0",
        "offer_created": "2025-09-02T05:44:49.000",
        "manufacturerName": "Hyundai",
        "modelName": "The New Genesis Coupe",
        "gradeName": "200 Turbo S",
        "modelGroupName": "Genesis",
        "yearMonth": "201203",
        "images": [
          {
            "code": "001",
            "path": "/carpicture02/pic4042/40428521_001.JPG",
            "type": "OUTER"
          }
        ],
        "advertisementType": "NORMAL",
        "created_at": "2025-09-02T00:47:21.243",
        "extra": "{diagnosis:{...},inspection:{...},accidents:[...]}",
        "options": {
          "standard": [
            "001",
            "003",
            "006",
            "007",
            "008"
          ],
          "choice": [
            "1052"
          ],
          "tuning": [
            "015",
            "016",
            "017",
            "018",
            "021"
          ]
        }
      }
    },
    {
      "id": 2664811,
      "inner_id": "39969819",
      "change_type": "changed",
      "created_at": "2025-08-17T05:19:34.442",
      "data": {
        "new_price": 34900000
      }
    },
    {
      "id": 2664812,
      "inner_id": "39971229",
      "change_type": "removed",
      "created_at": "2025-08-17T05:19:39.778"
    }
  ],
  "meta": {
    "cur_from_id": "2664810",
    "limit": 10
  }
}