
Copart APIScraper e parser
Copart API: lotes do leilão online com lance atual, preço Buy It Now, estimativas de valor de retalho e reparação, danos e título. Feed de lances e ficheiros.
Copart API
O parser recolhe os lotes de automóveis ligeiros da Copart, o leilão automóvel online, nos EUA e no Canadá. Com a API pode acompanhar os lances dos modelos de que precisa e filtrar os lotes pelo estado onde o carro se encontra. Não precisa de manter um scraper próprio de copart.com.
Os novos lotes da Copart, os novos lances e os lotes retirados de venda chegam por /changes.
A exportação diária contém os lotes da Copart que estão à venda na data da exportação.
Lance e Buy It Now, estimativas de valor e de reparação, tipo de venda e data do leilão, danos e título de propriedade, chaves do carro, fotos com indicação do ângulo, panorama 360 e vídeo do motor.
O preço do lote é o lance atual. O Buy It Now, o valor estimado de varejo e o custo estimado da reparação vêm em campos separados.
URL Base
https://{access_name}.auto-api.com/api/v3/copartAutorização: api_key parâmetro
Fluxo de Trabalho
/filtersobter valores de filtro disponíveisCarregamento inicial:
/change_id?date=...obter ID inicial para o feed de alterações/offersbaixar todos os lotes, página por página/changes?change_id=...obter todas as alterações no banco de dados a partir do ID/offerum lote pelo inner_idPor onde começar:
1. Antes do primeiro carregamento, pegue o número de /change_id para a data de hoje e guarde-o. Depois percorra /offers página por página até o fim: na última página, next_page é null.
2. Depois, consulte /changes a partir desse número e, na próxima vez, passe o next_change_id da resposta. É assim que chegam os novos lotes, os novos lances e os lotes retirados de venda. Se next_change_id vier como null, não há eventos novos: repita a requisição mais tarde.
3. Para buscar pelos seus próprios critérios, chame /offers com filtros.
Formato dos dados
- Os tipos são mantidos: um número vem como número, uma lista como array, um valor ausente como null.
- Os valores de data e hora estão em UTC, por exemplo "2026-11-12T18:00:00Z". O fuso horário do pátio da Copart vem separadamente, em auction_timezone.
- O lance, o Buy It Now e as estimativas estão na moeda do lote: USD nos lotes dos EUA, CAD nos lotes do Canadá.
- Todos os lotes têm o mesmo conjunto de campos. Um valor ausente vem como null, por exemplo price em um lote sem lances. Listas vazias vêm como array vazio: photos em um lote sem fotos, lot_features em um lote sem marcações.
GET/filters
Retorna todos os valores possíveis para filtragem
https://{access_name}.auto-api.com/api/v3/copart/filters?api_key=YOUR_API_KEYResposta:
{
"mark": {
"Chevrolet": { "model": [..., "TAHOE", "TAHOE 1500", "TAHOE 4D LT", "TAHOE C1500", ...] },
"Hyundai": { "model": [..., "SONATA", "SONATA 2.0T SE/LTD", "SONATA GLS", ...] },
"Toyota": { "model": [..., "RAV4", "RAV4 AUTOMATIC 4WD", "RAV4 EV", "RAV4 HV", ...] },
...
},
"transmission_type": ["Automatic", "Manual", "None"],
"color": [..., "Beige", "Black", "BLK", "Blue", ...],
"body_type": [..., "Convertible", "Coupe", "CREW CHA", ...],
"engine_type": ["CNG", ..., "Diesel", "Electric", "Flex fuel", "Gasoline", "Hybrid", "Hydrogen"],
"drive_type": ["4x2", "4x4", "All-wheel drive", "Front-wheel drive", "Rear-wheel drive"],
"region": ["Alabama", "Alaska", "Alberta", "Arizona", ...]
}GET/offers
Lotes página por página, com ou sem filtros.
Parâmetros:
page(obrigatório) - número da páginamark, model- marca e modelo, com os valores de /filters, sem diferenciar maiúsculas de minúsculastransmission_type, color, body_type, engine_type, drive_type- transmissão, cor, carroceria, combustível e tração, com os valores de /filters, sem diferenciar maiúsculas de minúsculasregion- estado ou província pelo nome em /filters ou pelo código da Copart, por exemplo "Texas" ou "TX"year_from, year_to- intervalo do anokm_age_from, km_age_to- intervalo de quilometragem, em km. Os lotes do Canadá não aparecem com esse filtroprice_from, price_to- intervalo do lance atual, na moeda do lote. Lotes sem lances não aparecem com esses filtros
Para passar vários valores a um filtro, repita o parâmetro com colchetes: mark[]=Hyundai&mark[]=Kia
https://{access_name}.auto-api.com/api/v3/copart/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/copart/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&model=SONATA&year_from=2020https://{access_name}.auto-api.com/api/v3/copart/offers?api_key=YOUR_API_KEY&page=1®ion=Texas&price_to=3000Resposta:
{
"result": [
{
"id": 73519,
"inner_id": "45468636",
"change_type": "added",
"created_at": "2026-10-24T12:04:43Z",
"data": {
"id": 73519,
"inner_id": "45468636",
"url": "https://www.copart.com/lot/45468636/salvage-2021-hyundai-sonata-se-tx-houston-east",
"mark": "Hyundai",
"model": "SONATA",
"complectation": "SE",
"year": 2021,
"first_registration": null,
"km_age": 170309,
"odometer": 105825,
"odometer_status": "Actual",
"owners_count": null,
"price": 900,
"currency": "USD",
"buy_it_now_price": 2500,
"estimated_retail_value": 11200,
"repair_cost": 27596.5,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "Sedan",
"drive_type": "Front-wheel drive",
"color": "Blue",
"displacement": 2.5,
"displacement_cc": 2500,
"cylinders": 4,
"power": null,
"power_ice_hp": null,
"power_electro_kw": null,
"seat_count": null,
"section": "Used",
"seller_type": null,
"is_dealer": null,
"salon_id": null,
"seller": null,
"region": "Texas",
"city": "Houston",
"zip": "77049-1968",
"country": "USA",
"address": "TX - HOUSTON EAST",
"latitude": 29.85146,
"longitude": -95.15938,
"description": null,
"created_at": "2026-10-24T12:04:43Z",
"auction_at": "2026-11-12T18:00:00Z",
"auction_timezone": "CST",
"sale_type": "Minimum bid",
"condition": "Runs and drives",
"primary_damage": "Front end",
"secondary_damage": null,
"has_keys": true,
"title_type": "SALVAGE VEHICLE TITLE",
"title_group": "Salvage title",
"title_state": "Texas",
"lot_features": ["Hot item", "No license required"],
"photos": [
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/0da3a7d668234168bb57f702dd5fde62_hrs.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/d7bc5c3c7e154bd892aafccf6cf2e94e_hrs.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/a4886b15006f46fb874d1887c8ac789f_hrs.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/be3e06d1d70b498787070e0e498e2606_hrs.jpg",
...
],
"photo_details": [
{
"type": "Front left",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/0da3a7d668234168bb57f702dd5fde62_hrs.jpg"
},
{
"type": "Rear left",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/d7bc5c3c7e154bd892aafccf6cf2e94e_hrs.jpg"
},
{
"type": "Rear right",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/a4886b15006f46fb874d1887c8ac789f_hrs.jpg"
},
{
"type": "Front right",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/be3e06d1d70b498787070e0e498e2606_hrs.jpg"
},
...
],
"panorama_360": {
"exterior": [
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_0.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_1.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_2.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_3.jpg",
...
],
"interior": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/8ab2aa4018fa454b9965457c31763c77_O.jpeg"
},
"engine_video_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/d47a3ed97b4d4aa6a4b6e0321acdf582_O.mp4",
"vin": "5NPEG4JA0MH******",
"original": { // valores originais do copart.com
"mark": "HYUNDAI",
"model": "SONATA",
"complectation": "SE",
"engine_type": "GAS",
"transmission_type": "AUTOMATIC",
"body_type": "SEDAN",
"drive_type": "FRONT WHEEL DRIVE",
"color": "BLUE",
"region": "TX",
"city": "HOUSTON",
"country": "USA",
"odometer_status": "ACTUAL",
"sale_type": "Minimum Bid",
"condition": "RUNS AND DRIVES",
"primary_damage": "FRONT END",
"secondary_damage": null,
"title_group": "SALVAGE TITLE",
"title_state": "TX",
"lot_features": ["Hot Items", "No License Required"]
},
"catalog_ids": {
"mark": "HYUN",
"model": null,
"complectation": null
},
"options": null
}
}
// ... os demais lotes da página, até 20
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Campos de dados:
Lote e preço
id - ID interno do banco de dados
inner_id - Número do lote na Copart, o mesmo que aparece no link do lote. É com ele que se consulta o lote em /offer.
url - Página do lote em copart.com.
price, currency - Lance atual e moeda do lote, USD ou CAD. Sem lances, price é null. Não é o preço de venda: a Copart não o publica.
buy_it_now_price - Preço Buy It Now, se o vendedor o tiver definido; caso contrário, null.
estimated_retail_value - Valor estimado de varejo do carro, segundo a Copart.
repair_cost - Custo estimado da reparação, segundo a Copart, às vezes com centavos.
section - "Used" em todos os lotes.
description - Os lotes da Copart não têm descrição do vendedor, por isso o campo é sempre null.
created_at - Momento em que o lote apareceu no nosso banco de dados.
Carro
mark, model - Marca segundo uma lista de referência ("Hyundai", "Mercedes-Benz"), modelo como a Copart o escreve, em maiúsculas ("SONATA").
complectation - Versão como a Copart a escreve, por exemplo "SE".
year - Ano-modelo.
first_registration - A Copart não publica a data do primeiro registro, por isso o campo é sempre null.
vin - Máscara do VIN, como na Copart: 11 caracteres e asteriscos. Carros fabricados antes de 1981 têm um número mais curto.
km_age - Quilometragem em km nos lotes dos EUA. null nos lotes do Canadá.
odometer - Leitura do hodômetro, como na Copart, em milhas nos lotes dos EUA.
odometer_status - Status da leitura: "Actual", "Not actual", "Exempt" ou "Exceeds mechanical limits".
owners_count - A Copart não publica o número de proprietários, por isso o campo é sempre null.
Especificações
engine_type - Combustível, por exemplo "Gasoline", "Diesel", "Hybrid", "Electric" ou "Flex fuel".
transmission_type - "Automatic", "Manual" ou "None".
body_type - Tipo de carroceria, por exemplo "Sedan" ou "SUV".
drive_type - Tração: "Front-wheel drive", "Rear-wheel drive", "All-wheel drive", "4x4" ou "4x2", quando a Copart não informa qual eixo é o motriz.
color - Cor da carroceria.
displacement, displacement_cc - Cilindrada em litros e em centímetros cúbicos. null nos carros elétricos.
cylinders - Número de cilindros.
power, power_ice_hp, power_electro_kw, seat_count - A Copart não publica a potência nem o número de lugares, por isso esses campos são sempre null.
Condição e título de propriedade
primary_damage, secondary_damage - Dano principal e dano secundário, por exemplo "Front end" ou "Undercarriage".
condition - Condição segundo a verificação da Copart: "Runs and drives", "Engine starts" ou "Enhanced vehicle".
has_keys - Chaves do carro presentes (true) ou ausentes (false). null se a Copart não tiver informado.
title_type - Nome do título de propriedade como a Copart o escreve, em maiúsculas, por exemplo "SALVAGE VEHICLE TITLE". Cada estado tem seus próprios nomes.
title_group - Grupo do título: "Clean title", "Salvage title" ou "Non-repairable".
title_state - Estado ou província onde o título foi emitido.
Leilão e localização
auction_at - Data e hora do leilão em UTC. null enquanto o leilão não for marcado.
auction_timezone - Fuso horário do pátio da Copart, como aparece no site, por exemplo "CST".
sale_type - Tipo de venda: "Pure sale", "Minimum bid", "On approval" ou "Not on sale".
lot_features - Marcações do lote em uma lista, por exemplo "Hot item", "No license required" ou "Hybrid". Em um lote sem marcações, é um array vazio.
seller - Vendedor, se a Copart o mostrar: geralmente uma seguradora ou um revendedor. Caso contrário, null.
seller_type, is_dealer, salon_id - A Copart não publica o tipo de vendedor, por isso esses campos são sempre null.
country - "USA" ou "Canada".
region, city - Estado ou província e cidade do pátio onde o carro está.
zip - Código postal, no formato "77049-1968" nos lotes dos EUA.
address - Pátio da Copart onde o carro está, como aparece no site: "TX - HOUSTON EAST".
latitude, longitude - Coordenadas desse pátio da Copart.
Fotos, vídeos e dados de referência
photos - Fotos do lote, em ordem.
photo_details - As mesmas fotos com o ângulo (type), por exemplo "Front left", "Odometer" ou "Engine", e o link (url). Alguns lotes não têm essas indicações; nesse caso, null.
panorama_360 - Panorama 360: exterior traz os quadros da volta ao redor do carro, em ordem, e interior é uma foto esférica do interior do carro ou null. Sem panorama, o bloco inteiro é null.
engine_video_url - Vídeo com o som do motor em funcionamento (mp4).
options - A Copart não publica os equipamentos, por isso o campo é sempre null.
original - Valores dos campos principais do copart.com antes da tradução.
catalog_ids - Código da marca na Copart, por exemplo "HYUN". Não há códigos de modelo nem de versão, por isso esses valores são null.
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/v3/copart/change_id?api_key=YOUR_API_KEY&date=2026-11-10Resposta:
{
"change_id": 312400
}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/v3/copart/changes?api_key=YOUR_API_KEY&change_id=312412Resposta:
{
"result": [
{
"id": 312412,
"inner_id": "61238556",
"change_type": "changed",
"created_at": "2026-11-10T04:21:15Z",
"data": { // novo lance na moeda do lote (null se não restarem lances)
"new_price": 6600
}
},
{
"id": 312413,
"inner_id": "74646926",
"change_type": "added",
"created_at": "2026-11-10T04:21:16Z",
"data": { ... } // o corpo completo do lote, como em /offers
},
{
"id": 312414,
"inner_id": "65737096",
"change_type": "removed",
"created_at": "2026-11-10T04:21:19Z",
"data": {} // lote retirado de venda
}
// ... depois os demais eventos, até 20 por página
],
"meta": {
"cur_change_id": 312412,
"next_change_id": 312432,
"limit": 20
}
}GET/offer
Um lote pelo inner_id.
Parâmetros:
inner_id(obrigatório)
https://{access_name}.auto-api.com/api/v3/copart/offer?api_key=YOUR_API_KEY&inner_id=45468636A resposta traz apenas o objeto data, sem o result em volta dele.
Erros
Em caso de erro, a resposta traz o campo error com uma descrição: { "error": "parameter page is required" }
401- a api_key não foi aceita400- falta um parâmetro obrigatório ou um valor está no formato errado404- não há lote com esse inner_id (/offer)429- o limite de requisições se esgotou
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:
Parâmetros:
access_name- o seu subdomínio pessoaldate- data da exportação no formato aaaa-mm-dd, por ex. 2026-11-10file_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.csvExemplo de comando Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'A Copart (copart.com) organiza leilões online de automóveis, incluindo nos EUA e no Canadá. Os lotes estão distribuídos pelos pátios da Copart, cada um com o seu endereço e o seu fuso horário de leilão. Os carros são postos à venda por seguradoras, concessionários, bancos e empresas de aluguer.
A licitação decorre online: antes do início são aceites lances preliminares, e depois o lote é vendido num leilão virtual ao vivo. A venda pode ser sem preço mínimo, com lance mínimo ou sujeita a aprovação do vendedor, e alguns lotes têm preço Buy It Now. A Copart não mostra aos visitantes do site o VIN completo, o histórico de lances nem o preço de venda.
A marcação "No license required" indica os lotes em que não é preciso licença de concessionário para licitar. Com o estado e as coordenadas do pátio é possível estimar o transporte até ao porto.
Através de /changes chegam os novos lotes, os novos lances e as retiradas de venda. Um lote retirado de venda pode ter sido vendido ou cancelado.
Acesse dados de múltiplos mercados automotivos com APIs especializadas por plataforma: