DokumentaceAPI Reference

Dokumentace automobilového Scraper API. Naučte se, jak přistupovat k automobilovým datům prostřednictvím přímých API endpointů. Integrační průvodci a příklady kódu.

Oficiální SDK knihovny

Připravené klientské knihovny pro rychlou integraci API ve vašem preferovaném programovacím jazyce.

Dodáváme čistá, strukturovaná automobilová data přímo prostřednictvím API. To eliminuje potřebu složitého nastavení, správy infrastruktury nebo technické údržby.

Proč si vybrat nás

Odborné znalosti v oboru

Důvěryhodný poskytovatel API automobilových dat s více než 8 lety zkušeností od roku 2017.

Podpora 7 dní v týdnu

Náš specializovaný tým podpory je k dispozici 7 dní v týdnu, aby vám pomohl s integrací API.

Spolehlivost služby 24/7

Nepřetržité monitorování zajišťuje maximální provozuschopnost pro spolehlivé dodávání dat.

Klíčové schopnosti API | Scrapery a parsery

Upozornění na inzeráty v reálném čase

Získejte okamžitý přístup k API k novým automobilovým inzerátům a najděte příležitosti jako první.

Denní datové exporty

Získejte denní exporty aktivních a odstraněných inzerátů pro tržní analýzu a sledování prodejů.

Flexibilní exportní formáty

Získejte data ve formátech CSV, JSON, Excel a vlastních formátech pro snadnou integraci.

Často kladené otázky | API vs Scraper a Crawler

Jak funguje automobilové API?

Automobilové API poskytuje přístup v reálném čase k datům z předních automobilových tržišť. Dodává strukturovaná data prostřednictvím REST API pro okamžitou analýzu.

Jaké datové sady poskytuje automobilové API?

Automobilová data včetně specifikací, cen, informací o prodejci, umístění a najetých kilometrů. Přístup k milionům inzerátů z hlavních platforem prostřednictvím volání API.

Existují limity využití pro automobilové API?

Žádné limity využití s rate limitingem pro stabilní výkon. Získejte všechny aktivní inzeráty napříč regiony prostřednictvím API v reálném čase nebo denních exportů. Žádná omezení pro partnery.

Jak mohu sledovat nové automobilové inzeráty pomocí API v reálném čase?

Sledujte inzeráty pomocí parametru 'change_id'. Začněte s change_id=0, poté použijte ID poslední změny + 1. Zachycuje nové inzeráty, změny cen, odstranění napříč platformami.

Jaké datové formáty podporujete?

Data ve formátech CSV, JSON, Excel a databázových formátech. Všechny formáty obsahují data ze všech platforem.

Můžete poskytnout vlastní přístup k API pro konkrétní tržiště?

Ano, vytváříme vlastní řešení API pro jakékoli automobilové tržiště. Získejte přizpůsobený přístup k datům pro vaše specifické potřeby. Kontaktujte nás pro požadavky.

Je s mými daty a partnerstvím nakládáno důvěrně?

Ano. Pracujeme podle přísných dohod o důvěrnosti se všemi klienty. Vaše využití našich služeb automobilových dat zůstává zcela soukromé a bezpečné.

Musím spravovat jakoukoli infrastrukturu nebo servery?

Ne, je to plně spravované. Staráme se o veškerou infrastrukturu, servery a sběr dat. Získejte data připravená k použití bez technického nastavení.

Základní URL

https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}

Autorizace: api_key parameter

Pracovní postup

1
/filterszískat dostupné hodnoty filtrů
2
/offerszískat inzeráty (s filtry nebo bez nich) - použít pro počáteční načtení dat
3

Pro 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
4
/offerzískat detaily konkrétního inzerátu podle inner_id

Doporučený postup integrace:

1. Nejprve použijte /offers pro počáteční načtení dat (projděte všechny stránky)

2. Poté použijte /changes pro pravidelné získávání všech změn (přidané/upravené/odstraněné) pro synchronizaci vaší lokální databáze se zdrojem

3. Pro integraci dat na web můžete použít /offers s filtry a stránkováním (značka, model, cena, rok atd.)

GET/filters

Vrací všechny možné hodnoty pro filtrování

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

Odpověď:

{
  "mark": {
    "Hyundai": {
      "model": {
        "Sonata": {
          "configuration": {
            "DN8": { "complectation": ["Smart", "Modern", "Premium"] }
          }
        }
      }
    },
    "Kia": {
      "model": {
        "K5": {
          "configuration": {
            "DL3": { "complectation": ["LX", "EX", "SX"] }
          }
        }
      }
    }
  },
  "transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
  "color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
  "body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}

GET/offers

Seznam inzerátů s stránkováním a filtry

Parametry:

  • page (povinné) - číslo stránky
  • mark, model, configuration, complectation - filters (bez rozlišení velkých/malých písmen)
  • transmission_type, color, body_type, engine_type - filters (bez rozlišení velkých/malých písmen)
  • year_from, year_to - filtr rozsahu let
  • km_age_from, km_age_to - filtr rozsahu kilometrů
  • price_from, price_to - filtr rozsahu cen (v jednotkách 10 000 KRW)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=black

Odpověď:

{
  "result": [
    {
      "id": 3219435,
      "inner_id": "40427050",
      "change_type": "added",
      "created_at": "2025-09-08T12:02:03.000Z",
      "data": {
        "id": 1454012,
        "inner_id": "40427050",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "Diesel 2.2 4WD",
        "configuration": "Diesel 2.2 4WD",
        "complectation": "Prestige",
        "year": 2021,
        "color": "Black",
        "price": 3190,
        "price_won": "31900000",
        "km_age": 92842,
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "address": "Busan Gijang-gun",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Datová pole:

  • id - interní ID databáze
  • inner_id - ID inzerátu na platformě
  • url - odkaz na inzerát
  • mark - značka auta
  • model - model auta
  • generation - generace
  • configuration - konfigurace
  • complectation - výbava/verze
  • year - rok výroby
  • color - barva
  • price - cena (v jednotkách 10 000 KRW)
  • price_won - plná cena v KRW
  • km_age - nájezd v km
  • engine_type - typ motoru
  • transmission_type - typ převodovky
  • body_type - typ karoserie
  • address - adresa
  • seller_type - typ prodejce
  • is_dealer - příznak dealera (true/false)
  • section - sekce
  • seller - prodejce
  • salon_id - ID dealera
  • description - popis
  • displacement - objem motoru (cc)
  • offer_created - datum vytvoření inzerátu
  • images - pole URL obrázků
  • extra - další data (JSON)
  • options - seznam opcí

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/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Odpověď:

{ "change_id": 1547283 }

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/{platform}/changes?api_key=YOUR_API_KEY&change_id=1

Odpověď:

{
  "result": [
    {
      "id": 456,
      "inner_id": "40427050",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "40427051",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 3490 }
    },
    {
      "id": 458,
      "inner_id": "40427052",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}

GET/offer

Jednotlivý inzerát podle inner_id

Parametry:

  • inner_id (povinné)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050

Odpověď: objekt data (stejný jako v /offers, ale bez wrapperu result)

Získejte kompletní údaje o inzerátu zadáním původní URL z jakékoli podporované platformy. Ideální pro rychlé vyhledávání a získání jednoho inzerátu.

Základní URL

https://{access_name}.auto-api.com/api/v1/offer/info

Autorizace přes hlavičku x-api-key

POST/api/v1/offer/info

Pošlete POST požadavek s URL inzerátu pro získání kompletních dat

Parametry:

  • url (povinné) - odkaz na inzerát na jakékoli podporované platformě

Příklad požadavku:

curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'

Odpověď:

{
  "inner_id": "39225419",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
  "mark": "BMW",
  "model": "5-Series",
  "generation": "528i",
  "year": 2010,
  "year_month": "2010-08",
  "color": "Silver",
  "price": 880,
  "price_won": 8800000,
  "km_age": 132437,
  "engine_type": "Gasoline",
  "transmission_type": "Automatic",
  "body_type": "Sedan",
  "displacement": "2996",
  "power": "230",
  "vin": "WBAFR1105AC258998",
  "address": "Gwangju Seo-gu",
  "seller_type": "DEALER",
  "is_dealer": true,
  "offer_created": "2025-11-17",
  "images": [
    "https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
    "https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
  ]
}

Datová pole:

  • inner_id - ID inzerátu na platformě
  • url - odkaz na inzerát
  • mark - značka auta
  • model - model auta
  • generation - generace
  • year - rok výroby
  • year_month - rok a měsíc výroby
  • color - barva
  • price - cena v jednotkách 10000 KRW
  • km_age - nájezd v km
  • engine_type - typ motoru
  • transmission_type - typ převodovky
  • body_type - typ karoserie
  • displacement - objem motoru (cc)
  • power - výkon v koních
  • vin - VIN kód
  • address - adresa
  • seller_type - typ prodejce
  • is_dealer - příznak dealera (true/false)
  • offer_created - datum vytvoření inzerátu
  • images - pole URL obrázků

Zásady uchovávání dat

Soubory uloženy minimálně na 3+ dní

Plán dostupnosti API

Čerstvé denní soubory dostupné ke stažení

Formát CSV dat

CSV soubory používají pipe (|) jako oddělovač sloupců

Struktura URL:

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

Parametry požadavku:

  • access_name - váš přiřazený identifikátor subdomény
  • date - cílové datum ve formátu yyyy-mm-dd (např. 2025-09-06)
  • file_name - název exportního souboru s příponou

Dostupné formáty:

  • 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 cURL API požadavku

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 příkaz pro stažení

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