Alcopa Auction APIScraper et parser
Alcopa Auction API : lots d'enchères auto en France, prix de départ et enchère en cours, VIN, défauts, documents, photos. Événements par lot, stock quotidien.
Alcopa Auction API
Le parser et le scraper Alcopa Auction tournent de notre côté : vous récupérez via l'API les lots des enchères automobiles françaises, prêts à l'emploi, avec le prix de départ ou l'enchère en cours, la date et le lieu de la vente, les caractéristiques, le VIN, les défauts avec photos, les documents et les photos. Le flux de changements signale les nouveaux lots, les nouveaux prix et la clôture des enchères avec son motif.
Le flux de changements signale chaque nouveau lot Alcopa Auction, chaque nouveau prix ou nouvelle enchère et chaque clôture d'enchères.
Chaque jour, un fichier avec tous les lots Alcopa Auction en cours.
Prix et enchère, salle ou vente en ligne, date de la vente, année d'immatriculation, kilométrage, cylindrée et puissance, boîte, VIN et immatriculation, CO2, TVA récupérable, garantie, défauts de carrosserie, documents et photos.
URL de base
https://{access_name}.auto-api.com/api/v2/alcopaAutorisation : api_key paramètre
Flux de travail
/filtersobtenir les valeurs de filtre disponibles/offersobtenir les annonces (avec ou sans filtres) - utiliser pour le chargement initial des donnéesPour les mises à jour (maintenir les données à jour après le chargement initial) :
/change_id?date=...obtenir l'ID de départ pour le flux de changements/changes?change_id=...obtenir tous les changements dans la base de données à partir de l'ID/offerobtenir les détails d'une annonce spécifique par inner_idPar où commencer :
1. Appelez d'abord /change_id avec la date du jour à l'heure de Paris et conservez la réponse ; si elle vaut 0, réessayez un peu plus tard. Récupérez ensuite toutes les pages de /offers jusqu'à ce que next_page vaille null.
2. Lisez ensuite /changes à partir de l'ID conservé, en transmettant à chaque fois le next_change_id de la réponse : vous recevrez les nouveaux lots, les nouveaux prix et enchères, ainsi que les lots clôturés avec leur motif. Si next_change_id vaut null, il n'y a pas encore de nouvel événement : relancez la requête plus tard avec le même ID.
3. Pour la recherche sur commande, appelez /offers avec des filtres par marque, modèle, année, kilométrage, prix, carburant, boîte, catégorie de véhicule et couleur.
GET/filters
Retourne toutes les valeurs possibles pour le filtrage
https://{access_name}.auto-api.com/api/v2/alcopa/filters?api_key=YOUR_API_KEYRéponse :
{
"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 des annonces avec pagination et filtres
Paramètres :
page(requis) - numéro de pagemark, model- marque et modèle, orthographiés comme dans /filterstransmission_type, color, body_type, engine_type- boîte, couleur, catégorie de véhicule et carburant, sans distinction de casseyear_from, year_to- plage d'années de première immatriculationkm_age_from, km_age_to- plage de kilométrage, en kmprice_from, price_to- plage de prix du lot, en euros
https://{access_name}.auto-api.com/api/v2/alcopa/offers?api_key=YOUR_API_KEY&page=1https://{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=DieselRéponse :
{
"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 }
}Champs de la fiche
- id - numéro de la fiche dans notre base ; pour la relier au lot, utilisez inner_id
- inner_id - identifiant du lot sur Alcopa Auction ; une voiture proposée dans deux ventes a deux lots et deux inner_id
- url - lien vers le lot sur alcopa-auction.fr
- mark, model - marque et modèle, par exemple PEUGEOT et 308
- complectation - version du catalogue de la maison de ventes : modèle, moteur et finition sur une seule ligne
- title - titre du lot, la marque suivie de la version
- year - année de première immatriculation ; pour le matériel, année de fabrication
- price - enchère en cours ou prix de départ en euros, price_type précise lequel des deux ; -1 tant que la maison de ventes n'a pas fixé de prix
- km_age - kilométrage en km ; vide si le kilométrage est inconnu
- color - couleur de carrosserie, valeurs de /filters ; les teintes rares ou les noms constructeur arrivent tels qu'ils figurent sur le site
- engine_type - carburant, valeurs de /filters
- body_type - catégorie du véhicule d'après le certificat d'immatriculation, valeurs de /filters
- transmission_type - boîte de vitesses, valeurs de /filters
- displacement - cylindrée du moteur, en cm³ ; vide pour les véhicules électriques ou si la cylindrée n'est pas indiquée
- horse_power - puissance en ch tirée de la désignation de la version, par exemple BLUEHDI 130 donne 130 ; pour les hybrides dont la version comporte deux nombres, puissance du moteur thermique ; champ vide si la version ne contient pas de nombre
- vin - VIN complet ; pour le matériel, numéro de série
- condition - anomalies signalées par la maison de ventes : voyant au tableau de bord, bruit moteur, liquide de refroidissement ou embrayage à vérifier, traces de grêle et autres
- description - commentaire de la maison de ventes sur le lot : date de remise du certificat d'immatriculation, norme antipollution, éléments manquants et autres remarques
- region - salle de ventes ou parc de stockage des ventes en ligne où se trouve le véhicule ; le lieu de vente est indiqué à part, dans sale_site
- images - liens des photos sous forme de tableau JSON dans une chaîne
- extra_prep - objet imbriqué avec les données de la vente et de l'état, détaillé ci-dessous ; null quand une valeur est absente
Contenu de extra_prep
- product_id - identifiant du véhicule sur le site ; deux lots avec le même product_id concernent le même véhicule
- sale_id - identifiant de la vente
- sale_site - lieu de vente : nom de la salle, ou Internet pour une vente en ligne
- is_online_sale - true pour une vente en ligne
- sale_date - date de la vente
- sale_start - début de la vente en salle ou ouverture des enchères en ligne, horodatage avec fuseau horaire
- bidding_end - heure limite des enchères en ligne : fin de la vente en ligne ou clôture des enchères préalables à une vente en salle, horodatage avec fuseau horaire ; null si la maison de ventes n'affiche pas d'échéance
- lot_number - numéro d'ordre dans le catalogue de la vente ; null tant que le catalogue n'est pas numéroté
- price_type - current_bid si price contient l'enchère en cours, starting_price s'il s'agit du prix de départ
- fees_included - true si les frais de vente sont déjà compris dans le prix, comme dans les ventes en ligne ; en salle, ils s'ajoutent au prix
- bid_step - palier d'enchère minimal en euros pour les lots avec enchères en ligne
- in_preparation - false : l'API ne reçoit que les lots déjà préparés pour la vente, avec photos, défauts et documents quand ils existent
- non_roulant - true si le véhicule est non roulant ; ces lots sont réservés aux professionnels de l'automobile
- pro_only - true si seuls les professionnels de l'automobile peuvent enchérir sur le lot
- plate - numéro d'immatriculation
- first_registration - date de première immatriculation
- co2 - émissions de CO2, en g/km
- vat_recoverable - true si la TVA du véhicule est récupérable
- vehicle_type - rubrique de la maison de ventes : TOURISME pour les voitures particulières, UTILITAIRES pour les utilitaires, MATÉRIEL pour les engins, du chariot élévateur à la remorque
- engine_hours - heures de fonctionnement du matériel
- fiscal_power - puissance fiscale des deux-roues, sous forme de chaîne avec l'unité, par exemple 4 CV
- warranty - garantie de la maison de ventes incluse dans le lot : programme et durée ; null sans garantie
- battery_soh - capacité restante de la batterie d'un véhicule électrique ou hybride, en pourcentage, d'après le certificat ; null sans certificat
- damages - défauts de carrosserie : pour chacun, la zone et le type de réparation, en code et en clair ; types de réparation P peinture, TP tôlerie avec peinture, T débosselage, RP remplacement
- damage_images - photos des défauts
- documents - liens vers les documents du lot : technical_inspection pour le procès-verbal de contrôle technique, battery_certificate pour le certificat d'état de la batterie, vehicle_history pour le rapport d'historique du véhicule ; valables tant que le lot est en vente
GET/change_id
Obtenir le premier ID de changement par date (pour utiliser dans /changes)
Paramètres :
date(requis) - date au format yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/alcopa/change_id?api_key=YOUR_API_KEY&date=2026-09-30Réponse :
{ "change_id": 4816 }Utilisez la valeur retournée comme paramètre change_id dans /changes
GET/changes
Flux de changements (ajouté/modifié/supprimé)
Paramètres :
change_id(requis) - à partir de quel ID de changement
https://{access_name}.auto-api.com/api/v2/alcopa/changes?api_key=YOUR_API_KEY&change_id=4816Réponse :
{
"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 }
}Un événement removed avec le motif dans removed_reason : sold si le lot est vendu, ended si les enchères sont terminées ou si le lot a été remis en vente sans avoir été marqué vendu, gone si le lot a été retiré du site. Une même voiture peut être proposée à la fois en salle et en ligne : ce sont deux lots avec leurs propres prix et dates, que product_id permet de relier.
GET/offer
Annonce unique par inner_id
Paramètres :
inner_id(requis)
https://{access_name}.auto-api.com/api/v2/alcopa/offer?api_key=YOUR_API_KEY&inner_id=2910153Réponse : objet data (identique à /offers, mais sans l'enveloppe result)
Conservation
Les fichiers restent disponibles au moins 3 jours
Disponibilité
De nouveaux fichiers chaque matin
Format CSV
Les colonnes CSV sont séparées par le caractère pipe (|)
Structure de l'URL :
Paramètres :
access_name- votre sous-domaine personneldate- date de l'export au format aaaa-mm-jj, par ex. 2026-09-30file_name- nom du fichier avec extension
Fichiers disponibles :
- 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
Exemple de requête cURL
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvExemple de commande Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Alcopa Auction (alcopa-auction.fr) est depuis plusieurs années le numéro un des enchères automobiles en France par le chiffre d'affaires : des salles à Beauvais, Rennes, Tours, Nancy, Lyon, Marseille et en région parisienne, plus des ventes en ligne quotidiennes. Les véhicules sont confiés par des sociétés de leasing, des banques, des constructeurs avec leurs réseaux de concessionnaires et des flottes d'entreprise : le catalogue se compose donc surtout de retours de leasing et de véhicules de flotte.
Les ventes se déroulent de deux façons. En salle, les lots sont adjugés le jour fixé, et l'on peut enchérir en ligne avant le début de la vente ; les frais de vente s'ajoutent alors au prix. Dans les ventes en ligne, les enchères sont acceptées jusqu'à l'heure de clôture annoncée, et les frais de vente sont déjà inclus dans le prix. Une partie des lots, dont les véhicules non roulants, est réservée aux professionnels de l'automobile.
Pour un importateur, c'est un moyen d'acheter des véhicules sans la marge des revendeurs et d'en évaluer l'état d'après le relevé des défauts, le procès-verbal de contrôle technique et le rapport d'historique, quand la maison de ventes les a joints. Les nouveaux lots du modèle recherché arrivent sous forme d'événements dans le flux ; le VIN, la date de première immatriculation, la cylindrée et la puissance permettent de calculer à l'avance les droits de douane et taxes à l'importation, et la mention de TVA récupérable montre quels lots reviennent moins cher à l'exportation hors de l'UE.
Via /changes, vous recevez les nouveaux lots, les nouveaux prix et enchères, ainsi que la clôture des enchères avec son motif. Aucun parser de votre côté n'est nécessaire.
Étendez votre accès aux données automobiles sur les marchés mondiaux avec nos API de plateforme complètes :