Referenční příručka API

Dokumentace

Dokumentace EnCarAPI. Zjistěte, jak získat přístup k datům korejských aut přes koncové body API. Průvodci integrací a příklady kódu.

Zkušenosti v oboru

Poskytovatel API automobilových dat s mnohaletými zkušenostmi na korejském trhu.

Podpora 7 dní v týdnu

Tým podpory k dispozici 7 dní v týdnu pro pomoc s integrací API.

Služby 24/7

Nepřetržitý monitoring pro spolehlivé doručování dat.

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

Okamžitý přístup přes API k novým inzerátům aut ihned po jejich zveřejnění.

Denní exporty dat

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

Flexibilní formáty exportu

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

Základní URL

Všechny požadavky na API směřují na následující základní URL:

url

https://encarapi.com/api/v2/encar

Například pro získání nabídek:

http

GET https://encarapi.com/api/v2/encar/offers?page=1&api_key=YOUR_API_KEY

Autentizace

Ověřujte své požadavky pomocí API klíče. Předejte ho jako parametr dotazu nebo přes hlavičku Authorization.

bash

GET https://encarapi.com/api/v2/encar/offers?api_key=YOUR_API_KEY

# Or via header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://encarapi.com/api/v2/encar/offers?page=1

Pracovní postup integrace

Postupujte podle těchto čtyř kroků pro integraci s EnCarAPI.

Získat dostupné filtry

Získejte všechny možné hodnoty filtrů (značky, modely, konfigurace, barvy atd.)

GET /filters

Získat inzeráty vozidel

Načtěte stránkovaný seznam inzerátů s volitelnými filtry podle značky, modelu, roku, ceny a dalších.

GET /offers?page=1

Sledovat změny

Získejte identifikátor změny pro datum a poté dotazujte přidané, změněné a odstraněné inzeráty.

GET /change_id → GET /changes

Získat detaily inzerátu

Načtěte kompletní data konkrétního inzerátu podle jeho inner_id.

GET /offer?inner_id=...

Koncové body API

Všechny dostupné koncové body pro přístup k datům korejských vozidel.

Denní exporty

Stahujte kompletní exporty dat v různých formátech. Soubory jsou generovány denně a dostupné ke stažení.

Uchování dat

Soubory jsou uchovávány minimálně 3+ dny.

Denní aktualizace

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

Formát CSV

Soubory CSV používají svislítko (|) jako oddělovač sloupců.

Dostupné exportní soubory

Formát	Všechny aktivní	Nové denní	Odstraněné denní
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říklady stažení

bash

# Download all active listings as CSV
curl -L -X GET 'https://encarapi.com/2025-03-15/all_active.csv' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -o daily_car_data.csv

bash

# Download new daily listings as JSON
curl -L -X GET 'https://encarapi.com/2025-03-15/new_daily.json' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -o new_listings.json

bash

# Using wget
wget --method GET \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  'https://encarapi.com/2025-03-15/all_active.xlsx'

Často kladené otázky

Připraveni začít?

Kontaktujte nás na Telegramu pro získání přístupových údajů k API a začněte přistupovat k datům korejských aut ještě dnes.

Kontakt na Telegramu