O que me dá a Alcopa Auction API?

A Alcopa Auction API devolve os lotes de todas as vendas abertas da leiloeira, com filtros por marca, modelo, ano, quilometragem, preço, combustível e caixa, o registo de um lote pelo ID e o feed de eventos: novo lote, novo preço ou lance, fecho do leilão com o motivo.

Que dados há sobre cada lote?

Sobre a venda: preço de partida ou lance atual em euros, com a indicação de as comissões da leiloeira estarem ou não incluídas, sala ou venda online, data do leilão e número do lote. Sobre o carro: data da primeira matrícula, quilometragem, combustível, caixa, cilindrada e potência, VIN completo e matrícula, emissões de CO2, IVA recuperável, garantia da leiloeira, local onde está guardado e fotografias. Sobre o estado: danos na carroçaria por zona com fotos, notas sobre avarias, comentários da leiloeira, ligações para o relatório da inspeção técnica e para o relatório de histórico e, em parte dos elétricos e híbridos plug-in, o estado de saúde da bateria em percentagem.

O que significa o preço do lote?

O campo price traz o lance atual ou, enquanto não houver lances, o preço de partida; price_type indica qual dos dois. Nas vendas online, as comissões da leiloeira já estão incluídas no preço; nos leilões em sala, acrescem ao preço, e é isso que fees_included indica. Enquanto a leiloeira não definir um preço, price é -1, e o preço definido chega no feed como evento changed. A leiloeira não publica o preço de arrematação.

Como avaliar o estado do carro antes de licitar?

Se a leiloeira marcou os danos na carroçaria, o registo traz a lista: zona e tipo de reparação, pintura, chapa, desamolgamento ou substituição, mais as fotos dos danos. À parte vêm as notas da leiloeira, por exemplo uma luz acesa no painel ou a embraiagem a verificar, e os comentários ao lote. As ligações para o relatório da inspeção técnica, o relatório de histórico do veículo e o certificado da bateria chegam quando esses documentos existem e são válidas enquanto o lote estiver à venda.

Em que difere o Alcopa Auction do mobile.de e do AutoScout24?

No mobile.de e no AutoScout24, concessionários e particulares vendem carros a preços de retalho. No Alcopa Auction, empresas de leasing, bancos e frotas de empresa entregam os carros a leilão, e os lances começam no preço de partida. As três plataformas estão disponíveis através dos mesmos métodos da nossa API, por isso é fácil comparar os preços de partida do leilão com os preços de retalho dos mesmos modelos.

Em que formato chegam os dados?

As respostas da API vêm em JSON. Uma vez por dia são preparados ficheiros em três formatos (CSV, JSON, XLSX): todos os lotes abertos, os novos do dia e os fechados do dia. Os ficheiros têm os mesmos campos que a API.

Alcopa Auction APIScraper e parser

Alcopa Auction API: lotes do leilão automóvel francês com preço de partida e lance atual, VIN, danos, documentos e fotos. Eventos por lote, stock diário.

Bibliotecas SDK oficiais

Os nossos SDKs trazem os métodos da API como funções prontas a usar, e o código das bibliotecas é aberto e está no GitHub.

PHP Node.js Python Go C#Java Ruby Rust

Alcopa Auction API

O parser e o scraper do Alcopa Auction funcionam do nosso lado. Recebe pela API os lotes do leilão automóvel francês já prontos a usar: preço de partida ou lance atual, data e local do leilão, especificações, VIN, danos com fotos, documentos e fotografias. O feed de alterações avisa dos novos lotes, do novo preço e do fecho do leilão com o motivo.

API

O feed de alterações avisa de cada lote novo no Alcopa Auction, de cada novo preço ou lance e do fecho do leilão.

Exportações diárias

Um ficheiro por dia com todos os lotes abertos no Alcopa Auction.

Dados completos

Preço e lance, sala ou venda online, data do leilão, ano de matrícula, quilometragem, cilindrada e potência, caixa, VIN e matrícula, CO2, IVA recuperável, garantia, danos na carroçaria, documentos e fotos.

Obter acesso à APIAcesso fornecido em 2 minutos

API

URL Base

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

Autorização: api_key parâmetro

Fluxo de Trabalho

/filtersobter valores de filtro disponíveis

/offersobter listagens (com ou sem filtros) - usar para carregamento inicial de dados

Para atualizações (manter dados atualizados após o carregamento inicial):

/change_id?date=...obter ID inicial para o feed de alterações

/changes?change_id=...obter todas as alterações no banco de dados a partir do ID

/offerobter detalhes de uma listagem específica por inner_id

Por onde começar:

1. Primeiro, chame /change_id com a data de hoje à hora de Paris e guarde a resposta; se vier zero, tente novamente um pouco mais tarde. Depois descarregue todas as páginas de /offers, até next_page vir null.

2. A seguir, leia /changes a partir do ID guardado, passando sempre o next_change_id da resposta: assim recebe os novos lotes, os novos preços e lances e os lotes fechados com o motivo. Se next_change_id vier null, ainda não há eventos novos: repita o pedido mais tarde com o mesmo ID.

3. Para procurar carros por encomenda, chame /offers com filtros por marca, modelo, ano, quilometragem, preço, combustível, caixa, categoria do veículo e cor.

GET/filters

Retorna todos os valores possíveis para filtragem

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

Resposta:

{
  "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 listagens com paginação e filtros

Parâmetros:

page (obrigatório) - número da página
mark, model - marca e modelo, escritos como em /filters
transmission_type, color, body_type, engine_type - caixa, cor, categoria do veículo e combustível, sem distinção de maiúsculas
year_from, year_to - intervalo do ano da primeira matrícula
km_age_from, km_age_to - intervalo de quilometragem, em km
price_from, price_to - intervalo do preço do lote, em euros

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

Resposta:

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

id - número do registo na nossa base de dados; para associar ao lote, use inner_id
inner_id - identificador do lote no Alcopa Auction; um carro colocado em duas vendas tem dois lotes e dois inner_id
url - ligação para o lote em alcopa-auction.fr
mark, model - marca e modelo, por exemplo PEUGEOT e 308
complectation - versão do catálogo da leiloeira: modelo, motor e equipamento numa só linha
title - título do lote, marca mais versão
year - ano da primeira matrícula; nos equipamentos, ano de fabrico
price - lance atual ou preço de partida em euros, conforme indicado em price_type; -1 enquanto a leiloeira não definir o preço
km_age - quilometragem em km; vazio se a quilometragem for desconhecida
color - cor da carroçaria, valores de /filters; as cores raras e os nomes de fábrica chegam tal como estão na plataforma
engine_type - combustível, valores de /filters

body_type - categoria do veículo segundo o certificado de matrícula, valores de /filters
transmission_type - caixa de velocidades, valores de /filters
displacement - cilindrada do motor, em cm³; vazio nos elétricos ou quando a cilindrada não está indicada
horse_power - potência em cv retirada da designação da versão, por exemplo BLUEHDI 130 dá 130; nos híbridos com dois números, a do motor de combustão; sem número na versão, o campo fica vazio
vin - VIN completo; nos equipamentos, número de série de fábrica
condition - notas da leiloeira sobre avarias: luz no painel, ruído do motor, líquido de refrigeração ou embraiagem a verificar, marcas de granizo e outras
description - comentário da leiloeira ao lote: quando é entregue o certificado de matrícula, classe ambiental, o que está em falta e outras notas
region - sala da leiloeira ou armazém das vendas online onde o carro se encontra; o local do leilão vem à parte, em sale_site
images - ligações das fotos como array JSON dentro de uma cadeia
extra_prep - objeto aninhado com os dados da venda e do estado, descrito abaixo; quando falta um valor, vem null

Dentro de extra_prep

product_id - identificador do carro na plataforma; dois lotes com o mesmo product_id dizem respeito ao mesmo carro
sale_id - identificador da venda
sale_site - local do leilão: nome da sala ou, nas vendas online, Internet
is_online_sale - true nas vendas online
sale_date - data do leilão
sale_start - início do leilão em sala ou abertura dos lances online, hora com fuso horário
bidding_end - até quando são aceites lances online: fecho da venda online ou receção de lances antecipados antes do leilão em sala, hora com fuso horário; null se a leiloeira não mostrar o prazo
lot_number - número de ordem no catálogo da venda; null enquanto a leiloeira não numerar o catálogo
price_type - current_bid, se price traz o lance atual; starting_price, se traz o preço de partida
fees_included - true se as comissões da leiloeira já estão no preço, como nas vendas online; nos leilões em sala, acrescem ao preço
bid_step - incremento mínimo do lance em euros, nos lotes com lances online
in_preparation - false: a API só inclui lotes que a leiloeira já preparou para venda, com fotos, danos e documentos, quando existem
non_roulant - true se o carro não se desloca pelos próprios meios; esses lotes só estão disponíveis para profissionais do setor automóvel
pro_only - true se só os profissionais do setor automóvel podem licitar no lote

plate - matrícula
first_registration - data da primeira matrícula
co2 - emissões de CO2, em g/km
vat_recoverable - true se o carro tem IVA recuperável
vehicle_type - secção da leiloeira: TOURISME ligeiros de passageiros, UTILITAIRES comerciais, MATÉRIEL equipamentos, de empilhadores a reboques
engine_hours - horas de funcionamento, nos equipamentos
fiscal_power - potência fiscal dos motociclos, em texto com a unidade, por exemplo 4 CV
warranty - garantia da leiloeira incluída no lote: programa e prazo; null sem garantia
battery_soh - capacidade restante da bateria do elétrico ou híbrido, em percentagem, segundo o certificado; null sem certificado
damages - danos na carroçaria: cada um com zona e tipo de reparação, em código e por extenso; tipos de reparação: P pintura, TP chapa com pintura, T desamolgamento, RP substituição
damage_images - fotografias dos danos
documents - ligações para os documentos do lote: technical_inspection relatório da inspeção técnica, battery_certificate certificado de estado da bateria, vehicle_history relatório de histórico do veículo; válidas enquanto o lote estiver à venda

GET/change_id

Obter primeiro ID de alteração por data (para usar em /changes)

Parâmetros:

date (obrigatório) - data no formato yyyy-mm-dd

https://{access_name}.auto-api.com/api/v2/alcopa/change_id?api_key=YOUR_API_KEY&date=2026-09-30

Resposta:

{ "change_id": 4816 }

Use o valor retornado como parâmetro change_id em /changes

GET/changes

Feed de alterações (adicionado/alterado/removido)

Parâmetros:

change_id (obrigatório) - a partir de qual ID de alteração

https://{access_name}.auto-api.com/api/v2/alcopa/changes?api_key=YOUR_API_KEY&change_id=4816

Resposta:

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

Um evento removed com o motivo em removed_reason: sold, se o lote foi vendido; ended, se o leilão terminou ou o lote foi colocado de novo à venda sem indicação de venda; gone, se o lote foi retirado da plataforma. Um mesmo carro pode estar em leilão em sala e online ao mesmo tempo: são dois lotes, com preços e datas próprios, que se ligam por product_id.

GET/offer

Listagem única por inner_id

Parâmetros:

inner_id (obrigatório)

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

Resposta: objeto data (igual a /offers, mas sem o wrapper result)

Exportações diárias

Retenção

Os ficheiros ficam disponíveis pelo menos 3 dias

Disponibilidade

Ficheiros novos todas as manhãs

Formato CSV

As colunas do CSV são separadas pelo caráter pipe (|)

Estrutura do URL:

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

Parâmetros:

access_name - o seu subdomínio pessoal
date - data da exportação no formato aaaa-mm-dd, por ex. 2026-09-30
file_name - nome do ficheiro com extensão

Ficheiros disponíveis:

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

Exemplo de pedido 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.csv

Exemplo de comando Wget

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

Alcopa Auction

O Alcopa Auction (alcopa-auction.fr) é há vários anos a leiloeira automóvel com maior volume de negócios em França: salas em Beauvais, Rennes, Tours, Nancy, Lyon, Marselha e perto de Paris, mais vendas online todos os dias. Os carros são entregues a leilão por empresas de leasing, bancos, fabricantes com as suas redes de concessionários e frotas de empresa, por isso o catálogo é composto sobretudo por carros de fim de leasing e devoluções de frotas.

O leilão decorre de duas formas. Nas salas, os lotes são arrematados no dia marcado, e até ao início é possível deixar um lance online; nesse caso, as comissões da leiloeira acrescem ao preço. Nas vendas online, os lances são aceites até à hora de fecho anunciada, e as comissões já estão incluídas no preço. Parte dos lotes, incluindo carros que não se deslocam pelos próprios meios, é vendida apenas a profissionais do setor automóvel.

Para um importador, é uma forma de comprar carros antes da margem do concessionário e de avaliar o estado pela marcação de danos, pelo relatório da inspeção técnica e pelo relatório de histórico, quando a leiloeira os anexa. Os lotes novos do modelo pretendido chegam como eventos no feed; com o VIN, a data da primeira matrícula, a cilindrada e a potência calculam-se de antemão os direitos aduaneiros e os impostos de importação, e a indicação de IVA recuperável mostra que lotes ficam mais baratos na exportação para fora da UE.

Através de /changes recebe os novos lotes, os novos preços e lances e o fecho do leilão com o motivo. Não precisa de um parser próprio para isso.

Outros Dados Automotivos

Acesse dados de múltiplos mercados automotivos com APIs especializadas por plataforma:

🇯🇵

Carsensor API

Japan dados automotivos API

🇯🇵

Goo-net Exchange API

Japan dados automotivos API

🇦🇪

Dubizzle API

UAE dados automotivos API