DokumentationAPI-Referenz

Automotive-Scraper-API-Dokumentation. Zugriff auf Fahrzeugdaten über API-Endpunkte. Integrationsleitfäden und Codebeispiele.

Saubere, strukturierte Fahrzeugdaten über API. Keine komplexe Einrichtung, Infrastrukturverwaltung oder technische Wartung nötig.

Warum uns wählen

Branchenerfahrung

Fahrzeugdaten-API-Anbieter mit über 8 Jahren Erfahrung seit 2017.

7-Tage-Support

Support-Team ist 7 Tage die Woche für API-Integration verfügbar.

24/7 Service

Rund-um-die-Uhr-Überwachung für zuverlässige Datenlieferung.

Wichtige API-Funktionen

Echtzeit-Inserate-Benachrichtigungen

Sofortiger API-Zugang zu neuen Fahrzeuginseraten, sobald sie veröffentlicht werden.

Tägliche Datenexporte

Tägliche Exporte aktiver und entfernter Inserate für Marktanalysen und Verkaufsverfolgung.

Flexible Exportformate

Daten in CSV, JSON, Excel und benutzerdefinierten Formaten für einfache Integration.

Häufig gestellte Fragen

Wie funktioniert die Fahrzeug-API?

Die Automotive-API bietet Echtzeitzugriff auf Daten von führenden Automarktplätzen. Sie liefert strukturierte Daten über eine REST-API zur sofortigen Analyse.

Welche Datensätze liefert die Fahrzeug-API?

Erhalten Sie vollständige Fahrzeugdaten einschließlich Spezifikationen, Preisen, Verkäuferdaten, Standort und Kilometerstand. Greifen Sie über API-Aufrufe auf Millionen von Inseraten großer Plattformen zu.

Gibt es Nutzungslimits für die Fahrzeug-API?

Keine Nutzungslimits, aber Ratenbegrenzung für eine stabile Leistung. Erhalten Sie alle aktiven Inserate aus allen Regionen via Echtzeit-API oder täglicher Exporte. Keine Einschränkungen für Enterprise-Partner.

Wie kann ich neue Fahrzeuginserate mit der Echtzeit-API verfolgen?

Überwachen Sie Inserate mit dem Parameter 'change_id'. Beginnen Sie mit change_id=0 und verwenden Sie dann die letzte Änderungs-ID + 1. Erfasst neue Inserate, Preisänderungen und Löschungen plattformübergreifend.

Welche Datenformate unterstützen Sie?

Erhalten Sie Daten in den Formaten CSV, JSON, Excel und Datenbankformaten. Alle Formate enthalten vollständige Daten von allen Plattformen.

Können Sie individuellen API-Zugang für einen bestimmten Marktplatz bereitstellen?

Ja, wir erstellen individuelle API-Lösungen für jeden Automarktplatz. Erhalten Sie maßgeschneiderten Datenzugriff für Ihre spezifischen Bedürfnisse. Kontaktieren Sie uns für Ihre Anforderungen.

Werden meine Datennutzung und Partnerschaft vertraulich behandelt?

Ja. Wir arbeiten mit allen Kunden unter strengen Vertraulichkeitsvereinbarungen. Ihre Nutzung unserer Fahrzeugdaten-Services bleibt vollständig privat und sicher.

Muss ich Infrastruktur oder Server verwalten?

Nein, es ist vollständig verwaltet. Wir kümmern uns um die gesamte Infrastruktur, die Server und die Datensammlung. Erhalten Sie sofort einsatzbereite Daten ohne technische Einrichtung.

Basis-URL

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

Autorisierung: api_key parameter

Arbeitsablauf

1
/filtersverfügbare Filterwerte abrufen
2
/offersAngebote abrufen (mit oder ohne Filter) - für initiales Laden verwenden
3

Für Updates (Daten nach initialem Laden aktuell halten):

/change_id?date=...Start-ID für Änderungs-Feed abrufen
/changes?change_id=...alle Änderungen in der Datenbank ab ID abrufen
4
/offerDetails eines bestimmten Inserats nach inner_id abrufen

Empfohlener Integrationsansatz:

1. Verwenden Sie zunächst /offers für den ersten Datenabruf (durchlaufen Sie alle Seiten)

2. Verwenden Sie dann /changes für den regelmäßigen Abruf aller Änderungen (hinzugefügt/geändert/entfernt), um Ihre lokale Datenbank mit der Quelle zu synchronisieren

3. Für die Website-Datenintegration können Sie /offers mit Filtern und Paginierung verwenden (Marke, Modell, Preis, Jahr usw.)

GET/filters

Gibt alle möglichen Werte zum Filtern zurück

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

Antwort:

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

Liste der Inserate mit Paginierung und Filtern

Parameter:

  • page (erforderlich) - Seitennummer
  • mark, model, configuration, complectation - filters (Groß-/Kleinschreibung ignorieren)
  • transmission_type, color, body_type, engine_type - filters (Groß-/Kleinschreibung ignorieren)
  • year_from, year_to - Jahrgangsbereich-Filter
  • km_age_from, km_age_to - Kilometerstand-Filter
  • price_from, price_to - Preisbereich-Filter (in 10.000 KRW-Einheiten)
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

Antwort:

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

Datenfelder:

  • id - interne Datenbank-ID
  • inner_id - Inserat-ID auf der Plattform
  • url - Link zum Inserat
  • mark - Automarke
  • model - Automodell
  • generation - Generation
  • configuration - Konfiguration
  • complectation - Ausstattung/Version
  • year - Baujahr
  • color - Farbe
  • price - Preis (in 10.000 KRW-Einheiten)
  • price_won - Vollpreis in KRW
  • km_age - Kilometerstand
  • engine_type - Motortyp
  • transmission_type - Getriebetyp
  • body_type - Karosserietyp
  • address - Adresse
  • seller_type - Verkäufertyp
  • is_dealer - Händler-Flag (true/false)
  • section - Bereich
  • seller - Verkäufer
  • salon_id - Händler-ID
  • description - Beschreibung
  • displacement - Hubraum (cc)
  • offer_created - Erstellungsdatum des Inserats
  • images - Array von Bild-URLs
  • extra - zusätzliche Daten (JSON)
  • options - Optionsliste

GET/change_id

Erste Änderungs-ID nach Datum abrufen (für Verwendung in /changes)

Parameter:

  • date (erforderlich) - Datum im Format yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Antwort:

{ "change_id": 1547283 }

Verwenden Sie den zurückgegebenen Wert als change_id-Parameter in /changes

GET/changes

Änderungs-Feed (hinzugefügt/geändert/entfernt)

Parameter:

  • change_id (erforderlich) - ab welcher Änderungs-ID
https://{access_name}.auto-api.com/api/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1

Antwort:

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

Einzelnes Inserat nach inner_id

Parameter:

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

Antwort: data-Objekt (wie in /offers, aber ohne result-Wrapper)

Rufen Sie vollständige Inseratsdaten ab, indem Sie die Original-URL von jeder unterstützten Plattform angeben. Ideal für schnelle Nachschlagevorgänge und den Abruf einzelner Inserate.

Basis-URL

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

Autorisierung über x-api-key Header

POST/api/v1/offer/info

Senden Sie eine POST-Anfrage mit der Inserats-URL, um vollständige Daten zu erhalten

Parameter:

  • url (erforderlich) - Link zum Inserat auf jeder unterstützten Plattform

Anfrage-Beispiel:

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

Antwort:

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

Datenfelder:

  • inner_id - Inserat-ID auf der Plattform
  • url - Link zum Inserat
  • mark - Automarke
  • model - Automodell
  • generation - Generation
  • year - Baujahr
  • year_month - Produktionsjahr und -monat
  • color - Farbe
  • price - Preis in 10000 KRW-Einheiten
  • km_age - Kilometerstand
  • engine_type - Motortyp
  • transmission_type - Getriebetyp
  • body_type - Karosserietyp
  • displacement - Hubraum (cc)
  • power - Leistung in PS
  • vin - FIN (Fahrzeugidentifikationsnummer)
  • address - Adresse
  • seller_type - Verkäufertyp
  • is_dealer - Händler-Flag (true/false)
  • offer_created - Erstellungsdatum des Inserats
  • images - Array von Bild-URLs

Datenspeicherungsrichtlinie

Dateien werden für mindestens 3+ Tage gespeichert

API-Verfügbarkeitsplan

Aktuelle tägliche Dateien zum Download verfügbar

CSV-Datenformat

CSV-Dateien verwenden Pipe (|) als Spaltentrennzeichen

URL-Struktur:

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

Anfrageparameter:

  • access_name - Ihre zugewiesene Subdomain-Kennung
  • date - Zieldatum im Format yyyy-mm-dd (z. B. 2025-09-06)
  • file_name - Name der Exportdatei mit Erweiterung

Verfügbare Formate:

  • 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

cURL API-Anfrage Beispiel

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-Download-Befehl

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