Dokumentace | AUTO-API.COM

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 'from_id'. Začněte s from_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í.

Dostupná datová pole

Naše API poskytuje přístup k datovým bodům, včetně:

Základní atributy vozidla

  • Značka a model
  • Rok a generace
  • Výbava a konfigurace
  • Typ karoserie
  • Barva exteriéru

Technické specifikace

  • Typ motoru a objem
  • Výkon v koních
  • Převodovka
  • Pohon
  • Stav tachometru

Data inzerátu na tržišti

  • Cena a měna
  • URL a ID inzerátu
  • Dostupnost
  • Datum zveřejnění
  • Úplný popis

Údaje o prodejci a umístění

  • Region a město
  • Typ prodejce (prodejce/soukromý)
  • Kontaktní informace
  • Historie vozidla
  • Fotografie a možnosti

* Dostupnost datových polí se liší podle zdrojového tržiště a úplnosti inzerátu.

Denní datové exporty

Uchovávání dat

Exportní soubory udržovány s bezpečným minimálním 3denním uložením plus automatizovaným archivačním systémem.

Dostupnost exportů

Denní datové exporty s aktualizovaným obsahem dostupné ke stažení každý den

Detaily formátu CSV

CSV soubory používají oddělovač svislou čáru (|) jako standardní oddělovač sloupců napříč všemi datovými sadami.

Struktura URL:

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

Parametry požadavku:

  • personal_name - váš jedinečný přiřazený identifikátor subdomény.
  • date - cílové datum pro data ve formátu yyyy-mm-dd (např. 2025-09-06).
  • file_name - název exportního souboru včetně jeho přípony.

Dostupné formáty:

  • 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

Příklad API požadavku 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

Wget příkaz pro stažení

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Dokumentace API v reálném čase

Parametry API požadavku

api_key - Váš jedinečný API klíč pro autentizaci.

from_id - ID změny, od kterého získat data. Použijte 0 pro počáteční požadavek, poté ID poslední přijaté + 1.

Pole API odpovědi

inner_id - Permanentní, jedinečné ID inzerátu na zdrojovém tržišti.

change_type - Typ události: "added", "changed" (např. aktualizace ceny) nebo "removed".

created_at - Časové razítko označující, kdy došlo k události.

Příklad těla odpovědi

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