API de Anúncios de Carros para Encar, Mobile.de, Che168, Dongchedi e Mais

EncarMobile.deAutoScout24Che168GuaziDongchedi+9 mais

Acesse dados de carros em tempo real e atualizações diárias via uma única API. Monitore novos anúncios, alterações de preço, publicações e remoções em tempo real em todas as plataformas.

Experimente a API AgoraVer DocumentaçãoAcesso fornecido em 2 minutos
100M+
anúncios
15+
plataformas
50+
campos de dados
Tempo de resposta<200ms
Status da API
operacional
API Reference

URL Base

https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}

Autorização: api_key parameter

Fluxo de Trabalho

1
/filtersobter valores de filtro disponíveis
2
/offersobter listagens (com ou sem filtros) - usar para carregamento inicial de dados
3

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
4
/offerobter detalhes de uma listagem específica por inner_id

Abordagem 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_KEY

Resposta:

{
  "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ágina
  • mark, 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 anos
  • km_age_from, km_age_to - filtro de intervalo de quilometragem
  • price_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=black

Resposta:

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

Resposta:

{ "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=1

Resposta:

{
  "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=40427050

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

Obter anúncio por URL

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/info

Autorizaçã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
Exportações Diárias

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:

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

Parâmetros da Requisição:

  • access_name - seu identificador de subdomínio atribuído
  • date - 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.csv

Comando de Download Wget

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

Integração Multi-Plataforma

Colete e normalize anúncios de carros de múltiplas plataformas globais em tempo real.

Processamento em Tempo Real

Obtenha os preços de carros mais recentes, disponibilidade e especificações com atualizações em tempo real.

Análise de Mercado

Dados completos do mercado para análises e insights reais.

Serviços Escaláveis

Exportações personalizadas em CSV, JSON, XML com entrega automatizada via API ou transferência direta.

Cobertura Global

Acesse dados de carros dos principais mercados incluindo Europa, América do Norte e Ásia.

Amigável para Desenvolvedores

API REST com docs completas e exemplos de código prontos.