Was bietet die Alcopa Auction API?

Die Alcopa Auction API liefert die Lose aller laufenden Auktionen des Auktionshauses mit Filtern nach Marke, Modell, Jahr, Laufleistung, Preis, Kraftstoff und Getriebe, den Datensatz eines Loses per ID und den Änderungsfeed: neues Los, neuer Preis oder neues Gebot, Auktionsende mit Grund.

Welche Daten gibt es zu einem Los?

Zum Verkauf: Startpreis oder aktuelles Gebot in Euro mit dem Vermerk, ob die Auktionsgebühren enthalten sind, Saalauktion oder Online-Auktion, Auktionstermin und Losnummer. Zum Fahrzeug: Datum der Erstzulassung, Laufleistung, Kraftstoff, Getriebe, Hubraum und Leistung, vollständige VIN und Kennzeichen, CO2-Ausstoß, ausweisbare MwSt., Garantie des Auktionshauses, Standort und Fotos. Zum Zustand: Karosserieschäden nach Zonen mit Fotos, Mängelhinweise, Kommentare des Auktionshauses, Links zum HU-Protokoll und zur Fahrzeughistorie, bei einem Teil der Elektroautos und Plug-in-Hybride der Batteriezustand in Prozent.

Was bedeutet der Preis eines Loses?

Im Feld price steht das aktuelle Gebot und, solange noch kein Gebot vorliegt, der Startpreis; welcher Wert es ist, zeigt price_type. Bei Online-Auktionen sind die Auktionsgebühren bereits im Preis enthalten, bei Saalauktionen werden sie zusätzlich berechnet; das zeigt fees_included. Solange das Auktionshaus keinen Preis festgelegt hat, ist price gleich -1; der festgelegte Preis kommt dann im Feed als Ereignis changed. Den Zuschlagspreis veröffentlicht das Auktionshaus nicht.

Wie lässt sich der Zustand des Fahrzeugs vor der Gebotsabgabe einschätzen?

Hat das Auktionshaus die Karosserieschäden erfasst, sind sie im Datensatz aufgelistet: Zone und Reparaturart, also Lackierung, Blecharbeiten, Ausbeulen oder Austausch, dazu Fotos der Schäden. Separat kommen Hinweise des Auktionshauses, etwa eine leuchtende Kontrollleuchte oder eine zu prüfende Kupplung, und Kommentare zum Los. Links zum HU-Protokoll, zur Fahrzeughistorie und zum Batteriezertifikat kommen, wenn diese Dokumente vorliegen, und gelten, solange das Los im Verkauf ist.

Worin unterscheidet sich Alcopa Auction von mobile.de und AutoScout24?

Auf mobile.de und AutoScout24 verkaufen Händler und Privatpersonen Fahrzeuge zu Endkundenpreisen. Bei Alcopa Auction geben Leasinggesellschaften, Banken und Firmenflotten ihre Fahrzeuge in die Auktion, geboten wird ab dem Startpreis. Alle drei Plattformen sind über dieselben Methoden unserer API verfügbar, deshalb lassen sich die Startpreise der Auktion leicht mit den Endkundenpreisen derselben Modelle vergleichen.

In welcher Form werden die Daten geliefert?

Die API antwortet in JSON. Einmal täglich stellen wir Dateien in drei Formaten bereit (CSV, JSON, XLSX): alle aktiven Lose, die neuen Lose des Tages und die geschlossenen Lose des Tages. Die Dateien haben dieselben Felder wie die API.

Alcopa Auction APIScraper & Parser

Alcopa Auction API: Lose der französischen Autoauktion mit Startpreis und aktuellem Gebot, VIN, Schäden, Dokumenten, Fotos. Ereignisse je Los, Bestand täglich.

Offizielle SDK-Bibliotheken

Unsere SDKs enthalten die API-Methoden als fertige Funktionen, der Quellcode der Bibliotheken ist auf GitHub öffentlich zugänglich.

PHP Node.js Python Go C#Java Ruby Rust

Alcopa Auction API

Den Alcopa-Auction-Scraper und -Parser betreiben wir, Sie rufen die fertigen Lose der französischen Autoauktion per API ab: Startpreis oder aktuelles Gebot, Termin und Ort der Auktion, technische Daten, VIN, Schäden mit Fotos, Dokumente und Fahrzeugfotos. Der Änderungsfeed meldet neue Lose, neue Preise und das Auktionsende mit Grund.

API

Der Änderungsfeed meldet jedes neue Los bei Alcopa Auction, jeden neuen Preis oder jedes neue Gebot und jedes Auktionsende.

Tägliche Exporte

Jeden Tag eine Datei mit allen aktiven Losen von Alcopa Auction.

Vollständige Daten

Preis und Gebot, Saalauktion oder Online-Auktion, Auktionstermin, Zulassungsjahr, Laufleistung, Hubraum und Leistung, Getriebe, VIN und Kennzeichen, CO2, ausweisbare MwSt., Garantie, Karosserieschäden, Dokumente und Fotos.

API-Zugang anfordernZugriff innerhalb von 2 Minuten gewährt

API

Basis-URL

https://{access_name}.auto-api.com/api/v2/alcopa

Autorisierung: api_key Parameter

Arbeitsablauf

/filtersverfügbare Filterwerte abrufen

/offersAngebote abrufen (mit oder ohne Filter) - für initiales Laden verwenden

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

/offerDetails eines bestimmten Inserats nach inner_id abrufen

So starten Sie:

1. Rufen Sie zuerst /change_id mit dem heutigen Datum nach Pariser Zeit auf und speichern Sie die Antwort; ist sie 0, wiederholen Sie die Anfrage etwas später. Laden Sie danach alle Seiten von /offers, bis next_page null ist.

2. Lesen Sie dann /changes ab der gespeicherten ID und übergeben Sie jedes Mal next_change_id aus der Antwort: So erhalten Sie neue Lose, neue Preise und Gebote sowie geschlossene Lose mit Grund. Ist next_change_id null, gibt es noch keine neuen Ereignisse: Wiederholen Sie die Anfrage später mit derselben ID.

3. Für die Fahrzeugbeschaffung auf Bestellung rufen Sie /offers mit Filtern nach Marke, Modell, Jahr, Laufleistung, Preis, Kraftstoff, Getriebe, Fahrzeugklasse und Farbe auf.

GET/filters

Gibt alle möglichen Werte zum Filtern zurück

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

Antwort:

{
  "mark": {
    "PEUGEOT": {
      "model": ["108", "2008", "208", "3008", "308", "5008", "508", "BOXER FOURGON", "EXPERT FOURGON", "PARTNER FOURGON"]
    },
    "RENAULT": {
      "model": ["ARKANA", "CAPTUR", "CLIO V", "KANGOO", "MEGANE IV BERLINE", "TRAFIC FOURGON", "TWINGO III"]
    },
    "CITROEN": {
      "model": ["BERLINGO", "C3", "C3 AIRCROSS", "C4", "C5 AIRCROSS", "JUMPY FOURGON"]
    }
  },
  "transmission_type": ["Automatic", "Manual", "Sequential"],
  "color": ["Beige", "Black", "Blue", "Brown", "Dark blue", "Dark grey", "Green", "Grey", "Light blue", "Light grey", "Orange", "Red", "Unknown", "White"],
  "body_type": ["Commercial vehicle", "Passenger car", "Special purpose vehicle", "Van"],
  "engine_type": ["Diesel", "Electric", "Ethanol (E85)", "Hybrid", "Petrol", "Petrol + LPG", "Plug-in hybrid"]
}

GET/offers

Liste der Inserate mit Paginierung und Filtern

Parameter:

page (erforderlich) - Seitennummer
mark, model - Marke und Modell in der Schreibweise aus /filters
transmission_type, color, body_type, engine_type - Getriebe, Farbe, Fahrzeugklasse und Kraftstoff, Groß-/Kleinschreibung egal
year_from, year_to - Bereich des Erstzulassungsjahres
km_age_from, km_age_to - Laufleistungsbereich in km
price_from, price_to - Bereich des Lospreises in Euro

https://{access_name}.auto-api.com/api/v2/alcopa/offers?api_key=YOUR_API_KEY&page=1

https://{access_name}.auto-api.com/api/v2/alcopa/offers?api_key=YOUR_API_KEY&page=1&mark=Peugeot&model=308&year_from=2018&km_age_to=150000&engine_type=Diesel

Antwort:

{
  "result": [
    {
      "id": 1018,
      "inner_id": "2910153",
      "change_type": "added",
      "created_at": "2026-09-30T15:43:04.158+03:00",
      "data": {
        "id": "1018",
        "inner_id": "2910153",
        "url": "https://www.alcopa-auction.fr/utilitaire-occasion/peugeot/308-bluehdi-130ch-s-s-bvm6-active-1119135",
        "mark": "PEUGEOT",
        "model": "308",
        "complectation": "308 BLUEHDI 130CH S&S BVM6 ACTIVE",
        "title": "PEUGEOT 308 BLUEHDI 130CH S&S BVM6 ACTIVE",
        "year": "2019",
        "price": "7000",
        "km_age": "82751",
        "color": "Blue",
        "engine_type": "Diesel",
        "body_type": "Passenger car",
        "transmission_type": "Manual",
        "displacement": "1499",
        "horse_power": "130",
        "vin": "VF3LBYHZPKS060872",
        "condition": "",
        "description": "sans roue de secours - euro 6",
        "region": "Beauvais",
        "images": "[\"https://photos.static.alcopa-auction.net/photos/2609/26091100167/internalCropped/PEUGEOT_308_251e1ed0e94e3c774aaf3c74.jpg\", \"https://photos.static.alcopa-auction.net/photos/2609/26091100167/internalCropped/PEUGEOT_308_bb42b3241c4495ea67690600.jpg\"]",
        "extra_prep": {
          "product_id": "1119135",
          "sale_id": "13052",
          "sale_site": "Internet",
          "is_online_sale": true,
          "sale_date": "2026-09-30",
          "sale_start": "2026-09-28T19:00:00+02:00",
          "bidding_end": "2026-09-30T16:00:00Z",
          "lot_number": 1071,
          "price_type": "current_bid",
          "fees_included": true,
          "bid_step": 100,
          "in_preparation": false,
          "non_roulant": false,
          "pro_only": false,
          "plate": "GC488AJ",
          "first_registration": "2019-03-29",
          "co2": 92,
          "vat_recoverable": false,
          "vehicle_type": "TOURISME",
          "engine_hours": null,
          "fiscal_power": null,
          "warranty": "Garantie Sérénité de 3 mois incluse",
          "battery_soh": null,
          "damages": [
            { "type": "P", "zone": "JAVG", "type_label": "Peinture", "zone_label": "Jante avant gauche" },
            { "type": "P", "zone": "AAVG", "type_label": "Peinture", "zone_label": "Aile avant gauche" }
            // ... other damages
          ],
          "damage_images": ["https://photos.static.alcopa-auction.net/photos/2609/26091100167/damages/2534668b56b764b8c1045955.jpg"],
          "documents": {
            "technical_inspection": "https://www.alcopa-auction.fr/getDocument/ct/bHgyWlRPaEV1N20rM3FTNDZqZVk0dz09",
            "vehicle_history": "https://api.b2b.autorigin.com/api/numberplate/ys8QGUQ2Vc/pdf?user=21&token=..."
          }
        }
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Felder des Datensatzes

id - Nummer des Datensatzes in unserer Datenbank; für die Zuordnung zum Los inner_id verwenden
inner_id - Loskennung bei Alcopa Auction; ein Fahrzeug in zwei Auktionen hat zwei Lose und zwei inner_id
url - Link zum Los auf alcopa-auction.fr
mark, model - Marke und Modell, z. B. PEUGEOT und 308
complectation - Version aus dem Katalog des Auktionshauses: Modell, Motor und Ausstattung in einer Zeile
title - Überschrift des Loses, Marke plus Version
year - Jahr der Erstzulassung; bei Maschinen das Baujahr
price - aktuelles Gebot oder Startpreis in Euro; welcher Wert es ist, steht in price_type; -1, solange das Auktionshaus keinen Preis festgelegt hat
km_age - Laufleistung in Kilometern; leer, wenn die Laufleistung unbekannt ist
color - Karosseriefarbe, Werte aus /filters; seltene und herstellereigene Bezeichnungen kommen wie auf der Plattform
engine_type - Kraftstoff, Werte aus /filters

body_type - Fahrzeugklasse laut Zulassungsbescheinigung, Werte aus /filters
transmission_type - Getriebe, Werte aus /filters
displacement - Hubraum in cm³; leer bei Elektroautos oder wenn der Hubraum nicht angegeben ist
horse_power - Leistung in PS aus der Versionsbezeichnung, z. B. BLUEHDI 130 ergibt 130; bei Hybriden mit zwei Zahlen die Leistung des Verbrennungsmotors; ohne Zahl in der Version bleibt das Feld leer
vin - vollständige VIN; bei Maschinen die Seriennummer
condition - Mängelhinweise des Auktionshauses: Kontrollleuchte, Motorgeräusch, Kühlmittel oder Kupplung prüfen, Hagelschäden und andere
description - Kommentar des Auktionshauses zum Los: wann die Zulassungsbescheinigung ausgehändigt wird, Abgasnorm, welches Zubehör fehlt und andere Hinweise
region - Auktionssaal oder Lager der Online-Auktionen, in dem das Fahrzeug steht; der Auktionsort kommt separat in sale_site
images - Fotolinks als JSON-Array in einem String
extra_prep - verschachteltes Objekt mit Verkaufs- und Zustandsdaten, unten beschrieben; fehlt ein Wert, kommt null

Inhalt von extra_prep

product_id - Fahrzeugkennung auf der Plattform; zwei Lose mit derselben product_id gehören zu einem Fahrzeug
sale_id - Kennung der Auktion
sale_site - Auktionsort: Name des Saals, bei Online-Auktionen Internet
is_online_sale - true bei Online-Auktionen
sale_date - Auktionstermin
sale_start - Beginn der Saalauktion oder Start der Online-Gebote, Zeit mit Zeitzone
bidding_end - bis wann Online-Gebote angenommen werden: Ende der Online-Auktion oder Ende der Vorgebote vor der Saalauktion, Zeit mit Zeitzone; null, wenn das Auktionshaus keine Frist anzeigt
lot_number - Position im Auktionskatalog; null, solange das Auktionshaus den Katalog nicht nummeriert hat
price_type - current_bid, wenn in price das aktuelle Gebot steht; starting_price, wenn der Startpreis
fees_included - true, wenn die Auktionsgebühren bereits im Preis enthalten sind, wie bei Online-Auktionen; bei Saalauktionen werden die Gebühren zusätzlich berechnet
bid_step - Mindestgebotsschritt in Euro bei Losen mit Online-Geboten
in_preparation - false: In die API gelangen Lose, die das Auktionshaus bereits zum Verkauf vorbereitet hat, mit Fotos, Schäden und Dokumenten, sofern vorhanden
non_roulant - true, wenn das Fahrzeug nicht fahrbereit ist; solche Lose sind nur für gewerbliche Händler zugänglich
pro_only - true, wenn nur gewerbliche Händler auf das Los bieten dürfen

plate - Kennzeichen
first_registration - Datum der Erstzulassung
co2 - CO2-Ausstoß in g/km
vat_recoverable - true, wenn die MwSt. ausweisbar ist
vehicle_type - Bereich der Auktion: TOURISME Pkw, UTILITAIRES Nutzfahrzeuge, MATÉRIEL Maschinen und Geräte, vom Stapler bis zum Anhänger
engine_hours - Betriebsstunden bei Maschinen
fiscal_power - Steuer-PS bei Motorrädern als String mit Einheit, z. B. 4 CV
warranty - im Los enthaltene Garantie des Auktionshauses: Programm und Laufzeit; null ohne Garantie
battery_soh - Restkapazität der Batterie bei Elektro- und Hybridfahrzeugen in Prozent laut Zertifikat; null ohne Zertifikat
damages - Karosserieschäden: je Schaden Zone und Reparaturart als Code und Bezeichnung; Reparaturarten P Lackierung, TP Blecharbeiten mit Lackierung, T Ausbeulen, RP Austausch
damage_images - Fotos der Schäden
documents - Links zu den Dokumenten des Loses: technical_inspection HU-Protokoll, battery_certificate Batteriezertifikat, vehicle_history Bericht zur Fahrzeughistorie; gültig, solange das Los im Verkauf ist

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/alcopa/change_id?api_key=YOUR_API_KEY&date=2026-09-30

Antwort:

{ "change_id": 4816 }

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/alcopa/changes?api_key=YOUR_API_KEY&change_id=4816

Antwort:

{
  "result": [
    {
      "id": 4816,
      "inner_id": "2906621",
      "change_type": "added",    // added - new lot
      "created_at": "2026-09-30T18:24:51.302+03:00",
      "data": { ... }            // full lot data, as in /offers
    },
    {
      "id": 4817,
      "inner_id": "2910153",
      "change_type": "changed",  // changed - new bid or starting price, EUR
      "created_at": "2026-09-30T18:25:07.118+03:00",
      "data": { "new_price": 7100 }
    },
    {
      "id": 4818,
      "inner_id": "2891028",
      "change_type": "removed",  // removed - lot closed: sold, ended or gone
      "created_at": "2026-09-30T18:26:40.655+03:00",
      "data": { "removed_reason": "sold" }
    }
  ],
  "meta": { "cur_change_id": 4816, "next_change_id": 4819, "limit": 20 }
}

Ein Ereignis removed mit dem Grund in removed_reason: sold, wenn das Los verkauft wurde; ended, wenn die Auktion beendet oder das Los ohne Verkaufsvermerk neu eingestellt wurde; gone, wenn das Los von der Plattform entfernt wurde. Ein Fahrzeug kann gleichzeitig im Saal und online angeboten sein, das sind zwei Lose mit eigenen Preisen und Terminen; verknüpfen lassen sie sich über product_id.

GET/offer

Einzelnes Inserat nach inner_id

Parameter:

inner_id (erforderlich)

https://{access_name}.auto-api.com/api/v2/alcopa/offer?api_key=YOUR_API_KEY&inner_id=2910153

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

Tägliche Exporte

Aufbewahrung

Dateien bleiben mindestens 3 Tage verfügbar

Verfügbarkeit

Jeden Morgen neue Dateien

CSV-Format

Die CSV-Spalten sind durch das Pipe-Zeichen (|) getrennt

URL-Struktur:

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

Parameter:

access_name - Ihre persönliche Subdomain
date - Exportdatum im Format jjjj-mm-tt, z. B. 2026-09-30
file_name - Dateiname mit Erweiterung

Verfügbare Dateien:

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

Beispiel für eine cURL-Anfrage

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

Beispiel für einen Wget-Befehl

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

Alcopa Auction

Alcopa Auction (alcopa-auction.fr) ist seit einigen Jahren das umsatzstärkste Autoauktionshaus Frankreichs: Auktionssäle in Beauvais, Rennes, Tours, Nancy, Lyon, Marseille und bei Paris, dazu tägliche Online-Auktionen. Eingeliefert werden die Fahrzeuge von Leasinggesellschaften, Banken, Autoherstellern mit ihren Händlernetzen und Firmenflotten, der Katalog besteht daher überwiegend aus Leasing- und Flottenrückläufern.

Versteigert wird auf zwei Wegen. Im Saal kommen die Lose am festgelegten Tag unter den Hammer, bis zum Beginn lässt sich online ein Gebot abgeben; die Auktionsgebühren werden dort zusätzlich berechnet. Bei Online-Auktionen werden Gebote bis zum angekündigten Ende angenommen, die Auktionsgebühren sind hier bereits im Preis enthalten. Ein Teil der Lose, darunter nicht fahrbereite Fahrzeuge, wird nur an gewerbliche Händler verkauft.

Für Importeure ist das ein Weg, Fahrzeuge ohne Händlermarge einzukaufen und den Zustand anhand der erfassten Schäden, des HU-Protokolls und der Fahrzeughistorie zu beurteilen, sofern das Auktionshaus sie beigefügt hat. Neue Lose des gesuchten Modells kommen als Ereignisse im Feed, aus VIN, Datum der Erstzulassung, Hubraum und Leistung lassen sich Zoll und Einfuhrabgaben vorab berechnen, und der Vermerk zur ausweisbaren MwSt. zeigt, welche Lose beim Export aus der EU günstiger sind.

Über /changes erhalten Sie neue Lose, neue Preise und Gebote sowie das Auktionsende mit Grund. Einen eigenen Parser brauchen Sie dafür nicht.

Andere Automobildaten

Erweitern Sie Ihre Fahrzeugdaten-Abdeckung auf globalen Märkten mit unseren umfassenden Plattform-APIs:

🇯🇵

Carsensor API

Japan Fahrzeugdaten API

🇯🇵

Goo-net Exchange API

Japan Fahrzeugdaten API

🇦🇪

Dubizzle API

UAE Fahrzeugdaten API