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
/filtersverfügbare Filterwerte abrufen/offersAngebote abrufen (mit oder ohne Filter) - für initiales Laden verwendenFü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/offerDetails eines bestimmten Inserats nach inner_id abrufenEmpfohlener 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_KEYAntwort:
{
"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) - Seitennummermark, model, configuration, complectation- filters (Groß-/Kleinschreibung ignorieren)transmission_type, color, body_type, engine_type- filters (Groß-/Kleinschreibung ignorieren)year_from, year_to- Jahrgangsbereich-Filterkm_age_from, km_age_to- Kilometerstand-Filterprice_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=blackAntwort:
{
"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-15Antwort:
{ "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=1Antwort:
{
"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=40427050Antwort: 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/infoAutorisierung ü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:
Anfrageparameter:
access_name- Ihre zugewiesene Subdomain-Kennungdate- 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.csvWget-Download-Befehl
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'