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.
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
/filterszískat dostupné hodnoty filtrů/offerszískat inzeráty (s filtry nebo bez nich) - použít pro počáteční načtení datPro 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/offerzískat detaily konkrétního inzerátu podle inner_idDoporuč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_KEYOdpověď:
{
"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ánkymark, 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 letkm_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=blackOdpověď:
{
"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-15Odpověď:
{ "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=1Odpověď:
{
"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=40427050Odpověď: 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/infoAutorizace 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:
Parametry požadavku:
access_name- váš přiřazený identifikátor subdoménydate- 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.csvWget příkaz pro stažení
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'