DocumentaçãoReferência da API
Documentação da API Scraper Automotivo. Aprenda como acessar dados de carros via endpoints de API diretos. Guias de integração e exemplos de código.
Dados limpos e estruturados direto pela API. Sem configuração complexa, sem gerenciar infra.
Por Que Nos Escolher
Expertise da Indústria
Um provedor confiável de API de dados automotivos com mais de 8 anos de experiência desde 2017.
Suporte 7 Dias por Semana
Nossa equipe de suporte dedicada está disponível 7 dias por semana para ajudar com sua integração de API.
Confiabilidade do Serviço 24/7
O monitoramento contínuo e ininterrupto garante tempo de atividade máximo para uma entrega confiável de dados.
Capacidades Principais da API | Scrapers & Parsers
Alertas de Anúncios em Tempo Real
Obtenha acesso instantâneo via API a novos anúncios de carros e encontre oportunidades primeiro.
Exportações Diárias de Dados
Exportações diárias de anúncios ativos e removidos para análise de mercado e rastreamento de vendas.
Formatos de Exportação Flexíveis
Dados em CSV, JSON, Excel e formatos personalizados para fácil integração.
Perguntas Frequentes | API vs Scraper & Crawler
Como funciona a API automotiva?
API automotiva fornece acesso em tempo real a dados dos principais marketplaces de carros. Entrega dados estruturados via API REST para análise imediata.
Quais conjuntos de dados a API automotiva fornece?
Dados completos de carros: especificações, preços, informações do vendedor, localização e quilometragem. Acesse milhões de anúncios das principais plataformas via chamadas de API.
Existem limites de uso para a API automotiva?
Sem limites de uso, com limitação de taxa para desempenho estável. Obtenha todos os anúncios ativos em regiões via API em tempo real ou exportações diárias. Sem restrições para parceiros empresariais.
Como posso rastrear novos anúncios de carros com a API em tempo real?
Monitore anúncios usando o parâmetro 'change_id'. Comece com change_id=0, depois use o último ID de mudança + 1. Isso captura novos anúncios, mudanças de preço e remoções em todas as plataformas.
Quais formatos de dados vocês suportam?
Dados em CSV, JSON, Excel e formatos de banco de dados. Todos os formatos contêm dados completos de todas as plataformas.
Vocês podem fornecer acesso à API personalizado para um marketplace específico?
Sim, construímos soluções de API personalizadas para qualquer marketplace de carros. Acesso a dados personalizado para suas necessidades específicas. Entre em contato para detalhar seus requisitos.
Meu uso de dados e parceria são mantidos confidenciais?
Sim. Trabalhamos sob acordos de confidencialidade estritos com todos os clientes. Seu uso de nossos serviços de dados de carros permanece completamente privado e seguro.
Preciso gerenciar alguma infraestrutura ou servidores?
Não, o serviço é totalmente gerenciado. Cuidamos de toda a infraestrutura, servidores e coleta de dados. Você obtém dados prontos para uso sem qualquer configuração técnica.
URL Base
https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}Autorização: api_key parameter
Fluxo de Trabalho
/filtersobter valores de filtro disponíveis/offersobter listagens (com ou sem filtros) - usar para carregamento inicial de dadosPara 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_idAbordagem de integração recomendada:
1. Primeiro, use /offers para a recuperação inicial de dados (percorra todas as páginas)
2. Em seguida, use /changes para a recuperação periódica de todas as alterações (adicionadas/modificadas/removidas) para sincronizar seu banco de dados local com a fonte
3. Para integração de dados no site, você pode usar /offers com filtros e paginação (marca, modelo, preço, ano, etc.)
GET/filters
Retorna todos os valores possíveis para filtragem
https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEYResposta:
{
"mark": {
"Hyundai": {
"model": {
"Sonata": {
"configuration": {
"DN8": { "complectation": ["Smart", "Modern", "Premium"] }
}
}
}
},
"Kia": {
"model": {
"K5": {
"configuration": {
"DL3": { "complectation": ["LX", "EX", "SX"] }
}
}
}
}
},
"transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
"color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
"body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
"engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}GET/offers
Lista de listagens com paginação e filtros
Parâmetros:
page(obrigatório) - número da páginamark, model, configuration, complectation- filters (não diferencia maiúsculas)transmission_type, color, body_type, engine_type- filters (não diferencia maiúsculas)year_from, year_to- filtro de intervalo de anoskm_age_from, km_age_to- filtro de intervalo de quilometragemprice_from, price_to- filtro de intervalo de preços (em unidades de 10.000 KRW)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=blackResposta:
{
"result": [
{
"id": 3219435,
"inner_id": "40427050",
"change_type": "added",
"created_at": "2025-09-08T12:02:03.000Z",
"data": {
"id": 1454012,
"inner_id": "40427050",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
"mark": "Hyundai",
"model": "Palisade",
"generation": "Diesel 2.2 4WD",
"configuration": "Diesel 2.2 4WD",
"complectation": "Prestige",
"year": 2021,
"color": "Black",
"price": 3190,
"price_won": "31900000",
"km_age": 92842,
"engine_type": "Diesel",
"transmission_type": "Automatic",
"body_type": "SUV",
"address": "Busan Gijang-gun",
"seller_type": "DEALER",
"is_dealer": true,
"images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
"extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Campos de dados:
- id - ID interno do banco de dados
- inner_id - ID da listagem na plataforma
- url - link para a listagem
- mark - marca do carro
- model - modelo do carro
- generation - geração
- configuration - configuração
- complectation - acabamento/versão
- year - ano de produção
- color - cor
- price - preço (em unidades de 10.000 KRW)
- price_won - preço completo em KRW
- km_age - quilometragem em km
- engine_type - tipo de motor
- transmission_type - tipo de transmissão
- body_type - tipo de carroceria
- address - endereço
- seller_type - tipo de vendedor
- is_dealer - indicador de concessionária (true/false)
- section - seção
- seller - vendedor
- salon_id - ID da concessionária
- description - descrição
- displacement - cilindrada do motor (cc)
- offer_created - data de criação da listagem
- images - array de URLs de imagens
- extra - dados adicionais (JSON)
- options - lista de opções
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/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15Resposta:
{ "change_id": 1547283 }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/{platform}/changes?api_key=YOUR_API_KEY&change_id=1Resposta:
{
"result": [
{
"id": 456,
"inner_id": "40427050",
"change_type": "added", // added - new listing
"created_at": "2025-01-15T10:30:00Z",
"data": { ... } // full listing data
},
{
"id": 457,
"inner_id": "40427051",
"change_type": "changed", // changed - price update
"created_at": "2025-01-15T10:31:00Z",
"data": { "new_price": 3490 }
},
{
"id": 458,
"inner_id": "40427052",
"change_type": "removed", // removed - listing deleted
"created_at": "2025-01-15T10:32:00Z"
}
],
"meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}GET/offer
Listagem única por inner_id
Parâmetros:
inner_id(obrigatório)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050Resposta: objeto data (igual a /offers, mas sem o wrapper result)
Recupere os dados completos do anúncio fornecendo o URL original de qualquer plataforma suportada. Ideal para pesquisas rápidas e recuperação de um único anúncio.
URL Base
https://{access_name}.auto-api.com/api/v1/offer/infoAutorização via cabeçalho x-api-key
POST/api/v1/offer/info
Envie uma solicitação POST com o URL do anúncio para obter dados completos
Parâmetros:
url(obrigatório) - link para o anúncio em qualquer plataforma suportada
Exemplo de solicitação:
curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'Resposta:
{
"inner_id": "39225419",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
"mark": "BMW",
"model": "5-Series",
"generation": "528i",
"year": 2010,
"year_month": "2010-08",
"color": "Silver",
"price": 880,
"price_won": 8800000,
"km_age": 132437,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "Sedan",
"displacement": "2996",
"power": "230",
"vin": "WBAFR1105AC258998",
"address": "Gwangju Seo-gu",
"seller_type": "DEALER",
"is_dealer": true,
"offer_created": "2025-11-17",
"images": [
"https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
"https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
]
}Campos de dados:
- inner_id - ID da listagem na plataforma
- url - link para a listagem
- mark - marca do carro
- model - modelo do carro
- generation - geração
- year - ano de produção
- year_month - ano e mês de produção
- color - cor
- price - preço em unidades de 10000 KRW
- km_age - quilometragem em km
- engine_type - tipo de motor
- transmission_type - tipo de transmissão
- body_type - tipo de carroceria
- displacement - cilindrada do motor (cc)
- power - potência em cv
- vin - código VIN
- address - endereço
- seller_type - tipo de vendedor
- is_dealer - indicador de concessionária (true/false)
- offer_created - data de criação da listagem
- images - array de URLs de imagens
Política de Retenção de Dados
Arquivos armazenados por no mínimo 3+ dias
Agenda de Disponibilidade da API
Arquivos diários atualizados disponíveis para download
Formato de Dados CSV
Arquivos CSV usam pipe (|) como separador de colunas
Estrutura da URL:
Parâmetros da Requisição:
access_name- seu identificador de subdomínio atribuídodate- data alvo no formato yyyy-mm-dd (ex: 2025-09-06)file_name- nome do arquivo de exportação com extensão
Formatos 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 Requisição cURL API
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvComando de Download Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'