Alcopa Auction APIScraper y parser
Alcopa Auction API: lotes de subastas de coches en Francia con precio de salida y puja, VIN, daños, documentos y fotos. Eventos por lote y stock diario.
Alcopa Auction API
Nos ocupamos del parser y el scraper de Alcopa Auction, y usted recibe por API los lotes de la subasta de coches francesa listos para usar: precio de salida o puja actual, fecha y lugar de la subasta, características, VIN, daños con fotos, documentos y fotografías. El feed de cambios avisa de los lotes nuevos, de los precios nuevos y del cierre de la subasta con el motivo.
El feed de cambios avisa de cada lote nuevo de Alcopa Auction, de los precios o pujas nuevos y del cierre de la subasta.
Un archivo al día con todos los lotes activos de Alcopa Auction.
Precio y puja, venta en sala u online, fecha de la subasta, año de matriculación, kilometraje, cilindrada y potencia, caja de cambios, VIN y matrícula, CO2, IVA recuperable, garantía, daños de carrocería, documentos y fotos.
URL base
https://{access_name}.auto-api.com/api/v2/alcopaAutorización: api_key parámetro
Flujo de trabajo
/filtersobtener valores de filtro disponibles/offersobtener listados (con o sin filtros) - usar para carga inicial de datosPara actualizaciones (mantener datos actualizados después de la carga inicial):
/change_id?date=...obtener ID inicial para el feed de cambios/changes?change_id=...obtener todos los cambios en la base de datos desde el ID/offerobtener detalles de un listado específico por inner_idPor dónde empezar:
1. Primero llame a /change_id con la fecha de hoy en hora de París y guarde la respuesta; si devuelve 0, vuelva a pedirlo un poco más tarde. Después descargue todas las páginas de /offers hasta que next_page sea null.
2. Luego lea /changes desde el ID guardado, pasando cada vez next_change_id de la respuesta: así le llegarán los lotes nuevos, los precios y pujas nuevos y los lotes cerrados con el motivo. Si next_change_id llega como null, todavía no hay eventos nuevos: repita la petición más tarde con el mismo ID.
3. Para buscar coches por encargo, llame a /offers con filtros por marca, modelo, año, kilometraje, precio, combustible, caja de cambios, categoría del vehículo y color.
GET/filters
Devuelve todos los valores posibles para filtrado
https://{access_name}.auto-api.com/api/v2/alcopa/filters?api_key=YOUR_API_KEYRespuesta:
{
"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
Lista de listados con paginación y filtros
Parámetros:
page(requerido) - número de páginamark, model- marca y modelo tal como se escriben en /filterstransmission_type, color, body_type, engine_type- caja, color, categoría del vehículo y combustible, sin distinguir mayúsculasyear_from, year_to- rango de año de primera matriculaciónkm_age_from, km_age_to- rango de kilometraje, en kmprice_from, price_to- rango de precio del lote, 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=DieselRespuesta:
{
"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 }
}Campos del registro
- id - número del registro en nuestra base de datos; para vincularlo con el lote, use inner_id
- inner_id - identificador del lote en Alcopa Auction; un coche que se ofrece en dos ventas tiene dos lotes y dos inner_id
- url - enlace al lote en alcopa-auction.fr
- mark, model - marca y modelo, por ejemplo PEUGEOT y 308
- complectation - versión del catálogo de la subasta: modelo, motor y acabado en una sola línea
- title - título del lote, marca más versión
- year - año de primera matriculación; en la maquinaria, año de fabricación
- price - puja actual o precio de salida en euros, según indique price_type; -1 mientras la casa de subastas no haya fijado precio
- km_age - kilometraje en kilómetros; vacío si el kilometraje es desconocido
- color - color de la carrocería, valores de /filters; los nombres poco comunes y los de fábrica llegan como en la plataforma
- engine_type - combustible, valores de /filters
- body_type - categoría del vehículo según el permiso de circulación, valores de /filters
- transmission_type - caja de cambios, valores de /filters
- displacement - cilindrada del motor, en cm³; vacío en los eléctricos o si no se indica la cilindrada
- horse_power - potencia en CV tomada de la denominación de la versión, por ejemplo BLUEHDI 130 da 130; en los híbridos con dos cifras, la del motor de combustión; si la versión no lleva cifra, el campo queda vacío
- vin - VIN completo; en la maquinaria, número de serie
- condition - avisos de la casa de subastas sobre averías: testigo en el cuadro, ruido del motor, revisar el líquido refrigerante o el embrague, marcas de granizo y otros
- description - comentario de la casa de subastas al lote: cuándo se entregará el permiso de circulación, norma de emisiones, qué elementos faltan y otras notas
- region - sala de subastas o almacén de ventas online donde está el coche; la sede de la venta va aparte, en sale_site
- images - enlaces de las fotos como array JSON dentro de una cadena
- extra_prep - objeto anidado con los datos de la venta y del estado, descrito más abajo; si falta un valor, llega null
Dentro de extra_prep
- product_id - identificador del coche en la plataforma; dos lotes con el mismo product_id son el mismo coche
- sale_id - identificador de la venta
- sale_site - sede de la venta: nombre de la sala; en las ventas online, Internet
- is_online_sale - true en las ventas online
- sale_date - fecha de la subasta
- sale_start - inicio de la venta en sala o apertura de las pujas online, hora con zona horaria
- bidding_end - hasta cuándo se aceptan pujas online: cierre de la venta online o fin de las pujas previas a la venta en sala, hora con zona horaria; null si la casa de subastas no muestra el plazo
- lot_number - número de orden en el catálogo de la venta; null mientras la casa de subastas no haya numerado el catálogo
- price_type - current_bid si price es la puja actual, starting_price si es el precio de salida
- fees_included - true si los gastos de subasta ya están en el precio, como en las ventas online; en las ventas en sala se añaden aparte
- bid_step - incremento mínimo de la puja en euros en los lotes con pujas online
- in_preparation - false: a la API llegan los lotes que la casa de subastas ya ha preparado para la venta, con fotos, daños y documentos cuando existen
- non_roulant - true si el coche no rueda; esos lotes solo están disponibles para profesionales del automóvil
- pro_only - true si en la subasta del lote solo pueden participar profesionales del automóvil
- plate - matrícula
- first_registration - fecha de primera matriculación
- co2 - emisiones de CO2, en g/km
- vat_recoverable - true si el coche tiene IVA recuperable
- vehicle_type - sección de la subasta: TOURISME turismos, UTILITAIRES vehículos comerciales, MATÉRIEL maquinaria, desde carretillas elevadoras hasta remolques
- engine_hours - horas de motor en la maquinaria
- fiscal_power - potencia fiscal de las motos, como cadena con su unidad, por ejemplo 4 CV
- warranty - garantía de la casa de subastas incluida en el lote: programa y duración; null sin garantía
- battery_soh - capacidad restante de la batería del eléctrico o híbrido en porcentaje, según el certificado; null sin certificado
- damages - daños de carrocería: cada uno con zona y tipo de reparación, en código y nombre; tipos de reparación: P pintura, TP chapa y pintura, T desabollado, RP sustitución
- damage_images - fotos de los daños
- documents - enlaces a los documentos del lote: technical_inspection informe de la inspección técnica, battery_certificate certificado del estado de la batería, vehicle_history informe de historial del vehículo; funcionan mientras el lote está en venta
GET/change_id
Obtener primer ID de cambio por fecha (para usar en /changes)
Parámetros:
date(requerido) - fecha en formato yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/alcopa/change_id?api_key=YOUR_API_KEY&date=2026-09-30Respuesta:
{ "change_id": 4816 }Use el valor devuelto como parámetro change_id en /changes
GET/changes
Feed de cambios (añadido/cambiado/eliminado)
Parámetros:
change_id(requerido) - a partir de qué ID de cambio
https://{access_name}.auto-api.com/api/v2/alcopa/changes?api_key=YOUR_API_KEY&change_id=4816Respuesta:
{
"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 evento removed con el motivo en removed_reason: sold si el lote se ha vendido, ended si la subasta ha terminado o el lote se ha vuelto a poner a la venta sin marca de vendido, gone si el lote se ha retirado de la plataforma. Un mismo coche puede estar a la venta a la vez en sala y online: son dos lotes con sus propios precios y fechas, y se pueden vincular por product_id.
GET/offer
Listado individual por inner_id
Parámetros:
inner_id(requerido)
https://{access_name}.auto-api.com/api/v2/alcopa/offer?api_key=YOUR_API_KEY&inner_id=2910153Respuesta: objeto data (igual que en /offers, pero sin envoltorio result)
Retención
Los archivos siguen disponibles al menos 3 días
Disponibilidad
Archivos nuevos cada mañana
Formato CSV
Las columnas del CSV se separan con el carácter pipe (|)
Estructura de la URL:
Parámetros:
access_name- su subdominio personaldate- fecha de la exportación en formato aaaa-mm-dd, p. ej. 2026-09-30file_name- nombre del archivo con extensión
Archivos 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
Ejemplo de petición 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.csvEjemplo de comando 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) es desde hace varios años la primera subasta de coches de Francia por facturación: salas en Beauvais, Rennes, Tours, Nancy, Lyon, Marsella y cerca de París, más ventas online diarias. Los coches los sacan a subasta empresas de leasing, bancos, fabricantes con sus redes de concesionarios y flotas de empresa, así que el catálogo se compone sobre todo de retornos de leasing y de flotas de empresa.
Las ventas son de dos tipos. En las salas los lotes se adjudican el día fijado, y antes de empezar se puede dejar una puja online; allí los gastos de subasta se añaden aparte. En las ventas online se aceptan pujas hasta la hora de cierre anunciada, y los gastos de subasta ya están incluidos en el precio. Algunos lotes, entre ellos los coches que no ruedan, se venden solo a profesionales del automóvil.
Para un importador es una forma de comprar coches sin el margen del concesionario y de valorar el estado por los daños marcados, el informe de la inspección técnica y el informe de historial, cuando la casa de subastas los adjunta. Los lotes nuevos del modelo que busca llegan como eventos en el feed; con el VIN, la fecha de primera matriculación, la cilindrada y la potencia se calculan de antemano los aranceles e impuestos de importación, y el indicador de IVA recuperable muestra qué lotes salen más baratos al exportarlos fuera de la UE.
A través de /changes llegan los lotes nuevos, los precios y pujas nuevos y el cierre de la subasta con el motivo. Para ello no necesita un parser propio.
Expanda su cobertura de datos automotrices en mercados globales con nuestras APIs de plataforma: