O que é a API Che168 e como funciona?

A API Che168 permite acessar dados do maior marketplace automotivo da China de forma programática e estruturada. Através de endpoints REST, você obtém informações detalhadas sobre milhões de veículos chineses, incluindo VINs completos, relatórios de inspeção técnica realizados por centros certificados, histórico completo de manutenção e dados de financiamento quando disponíveis. A API detecta novos anúncios em minutos após a publicação no Che168.com, rastreia alterações de preço e identifica quando veículos são vendidos ou removidos da plataforma. Isso permite análise em tempo real do mercado automotivo chinês sem necessidade de desenvolver e manter scrapers complexos.

Quais dados do Che168 o parser extrai?

Todos os dados do carro: marca, modelo, ano, preço, quilometragem, motor, transmissão, VIN, relatórios de inspeção, histórico de manutenção, informações do vendedor, fotos e condição do veículo.

Com que frequência os dados do Che168 são atualizados?

Os dados são atualizados em tempo real. Novos anúncios são detectados em minutos. Arquivos diários contêm todos os carros ativos e removidos.

Quais formatos a API Che168 suporta?

Múltiplos formatos: API REST para dados em tempo real, JSON para desenvolvimento, CSV para análise de dados e Excel para relatórios empresariais com dados estruturados de carros.

Posso obter números VIN através da API?

Sim, os códigos VIN estão disponíveis para a maioria dos anúncios do Che168. Eles estão incluídos na ficha detalhada do veículo através do endpoint /offer.

Com que frequência as exportações diárias são atualizadas?

Novos arquivos são gerados todas as manhãs. Eles contêm um snapshot completo dos anúncios ativos e uma lista de veículos removidos no dia anterior.

Quais regiões da China são cobertas?

Che168 cobre todas as províncias da China. Os dados incluem a localização do vendedor e permitem filtragem por cidades e regiões.

Che168 APIScraper e Parser

Acesse dados de veículos da plataforma automotiva da China. Números VIN, relatórios de inspeção, histórico de serviço. Monitoramento em tempo real de atualizações de anúncios.

API de Plataforma de Carros Che168

API Che168 com dados de veículos chineses: VINs, relatórios de inspeção, histórico de manutenção e especificações técnicas sem necessidade de scraper.

API em Tempo Real

Novos anúncios de carros do Che168 detectados em minutos da publicação.

Exportações Diárias

Arquivos diários com todos os anúncios atuais e dados de preços para rastreamento de mercado.

Parser de Dados

Dados estruturados direto via API: Preço, Quilometragem, Ano, Marca, Modelo, Especificações Técnicas, Relatórios de Inspeção, Histórico de Serviço e informações de Condição do Veículo.

Obter Acesso à APIAcesso fornecido em 2 minutos

API

URL Base

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

Autorização: api_key parâmetro

Fluxo de Trabalho

/filtersconsultar todas as opções de filtro disponíveis

/offersobter listagens de carros com paginação e filtragem - recomendado para importação em massa de dados

Para manter seus dados atualizados após a importação inicial:

/change_id?date=...obter o ID inicial para começar a rastrear alterações

/changes?change_id=...buscar todas as modificações desde um ID de alteração especificado

/offerrecuperar detalhes completos de uma listagem individual usando inner_id

Fluxo de trabalho de integração sugerido:

1. Comece com /offers para baixar o conjunto de dados completo (itere por todas as páginas)

2. Em seguida, consulte /changes em intervalos regulares para capturar todas as atualizações (adições/modificações/exclusões) e sincronize seu banco de dados

3. Para servir dados em seu site, use /offers com parâmetros de filtros e paginação (marca, modelo, preço, ano e mais)

GET/filters

Fornece todos os campos filtráveis e seus valores válidos

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

Resposta:

{
  "mark": {
    "BMW": { "model": ["X5", "X3", "3 Series"] },
    "Audi": { "model": ["A4", "A6", "Q7"] }
  },
  "transmission_type": ["Manual", "Automatic"],
  "color": ["White", "Black", "Silver", "Dark Gray", "Blue", "Red", "Brown", "Orange", "Yellow", "Green", "Purple", "Champagne", "Other"],
  "body_type": ["Crossover/SUV", "Sedan", "Hatchback", "Minivan", "Pickup", "Coupe/Roadster", "Microvan", "Light Truck", "Van", "Mini"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid", "Plug-in Hybrid", "Range Extender", "Hydrogen Fuel Cell", "Gasoline + 48V Mild Hybrid", "Gasoline + 24V Mild Hybrid", "Gasoline + CNG", "CNG"],
  "drive_type": ["FWD", "RWD", "AWD", "RWD (dual-motor)", "AWD (dual-motor)", "AWD (tri-motor)", "AWD (quad-motor)"]
}

GET/offers

Lista paginada de listagens de veículos com suporte a filtros

Parâmetros:

page (obrigatório) - número da página
mark, model, transmission_type, color, body_type, engine_type - filtros (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 CNY)

https://{access_name}.auto-api.com/api/v2/che168/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/che168/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=black

Resposta:

{
  "result": [
    {
      "id": 1273379,
      "inner_id": "55651236",
      "change_type": "added",
      "created_at": "2025-08-05T08:18:10.679Z",
      "data": {
        "id": 1273379,
        "inner_id": "55651236",
        "url": "https://www.che168.com/dealer/648815/55651236.html",
        "mark": "Lamborghini",
        "model": "Huracán",
        "title": "Huracán 2020 Huracán EVO RWD",
        "year": 2020,
        "color": "Red",
        "price": 1890000,
        "km_age": 19000,
        "engine_type": "Gasoline",
        "transmission_type": "Automatic",
        "body_type": "Sports Car",
        "drive_type": "RWD (mid-engine)",
        "address": "Shanghai, Minhang",
        "seller_type": "dealer",
        "is_dealer": true,
        "section": "Used",
        "salon_id": "648815",
        "description": "Shanghai Luxury Car Store: 166 detailed inspections...",
        "displacement": 5.2,
        "offer_created": "2025-08-05",
        "images": ["https://2sc2.autoimg.cn/escimg/auto/g34/M04/C4/EC/..."],
        "extra": {"inspection": {...}, "configuration": {...}},
        "power": 610
      }
    }
  ],
  "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
year - ano de produção
color - cor
price - preço em CNY
km_age - quilometragem em km
engine_type - tipo de motor
drive_type - tipo de tração

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
salon_id - ID da concessionária
displacement - cilindrada do motor
images - array de URLs de imagens
power - potência em cv

GET/change_id

Obter ID de alteração inicial para uma data dada (necessário para o endpoint /changes)

Parâmetros:

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

https://{access_name}.auto-api.com/api/v2/che168/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Resposta:

{ "change_id": 3294715 }

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

GET/changes

Feed de atualizações incrementais (registros adicionados/modificados/excluídos)

Parâmetros:

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

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

Resposta:

{
  "result": [
    {
      "id": 456,
      "inner_id": "55651236",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "55651237",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 1790000 }
    },
    {
      "id": 458,
      "inner_id": "55651238",
      "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

Informações detalhadas para uma listagem específica por inner_id

Parâmetros:

inner_id (obrigatório)

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

Resposta: objeto data único (mesmos campos que itens de /offers, retornado diretamente sem wrapper result)

Obter Anúncio por URL

Recuperar dados completos do anúncio fornecendo a URL do che168.com

URL Base

https://{access_name}.auto-api.com/api/v1/offer/info

Autorização: cabeçalho x-api-key

POST/api/v1/offer/info

Obter dados do anúncio do che168.com por URL

Parâmetros:

url (obrigatório) - link to the listing on che168.com

Exemplo de Requisiçã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": "https://www.che168.com/dealer/413863/56520004.html" }'

Resposta:

{
  "inner_id": "56520004",
  "url": "https://www.che168.com/dealer/413863/56520004.html",
  "mark": "Ora",
  "model": "Black Cat",
  "year": 2020,
  "color": "White",
  "price": 31800,
  "km_age": 54000,
  "engine_type": "Electric",
  "transmission_type": "Automatic",
  "body_type": "Mini",
  "drive_type": "FWD",
  "displacement": "0",
  "vin": "LGWECMA47LE008164",
  "city": "Shenzhen",
  "seller_type": "dealer",
  "is_dealer": true,
  "offer_created": "2025-12-04",
  "images": [
    "https://2sc2.autoimg.cn/escimg/auto/g33/M0B/AE/D7/1024x768_c42_autohomecar__ChxpVWj8TteALlI3AAnIctts-w8397.jpg.webp",
    "https://2sc2.autoimg.cn/escimg/auto/g34/M0B/A3/C5/1024x768_c42_autohomecar__ChxpWGj8TtiAJ0EJAAq9t0PZjQc486.jpg.webp"
  ],
  "power": 61,
  "first_registration": "2020-09"
}

Descrição dos Campos:

inner_id - ID do anúncio no che168.com
url - link para o anúncio
mark - marca do carro
model - modelo do carro
year - ano de produção
color - cor do veículo
price - preço em CNY
km_age - quilometragem em quilómetros

engine_type - tipo de motor/combustível
transmission_type - tipo de transmissão
body_type - tipo de carroçaria
drive_type - tipo de tração (dianteira, traseira, integral)
displacement - cilindrada do motor
vin - número de identificação do veículo
city - cidade do vendedor
seller_type - tipo de vendedor
is_dealer - indicador de revendedor
offer_created - data de criação do anúncio
images - matriz de URLs de imagens
power - potência do motor em cavalos (cv)
first_registration - data do primeiro registo (AAAA-MM)

Exportações Diárias de Dados

Armazenamento de Arquivos

Arquivos armazenados por no mínimo 3 dias

Agenda de Atualização

Novos arquivos de dados gerados diariamente e disponíveis para download

Formato de Arquivo

Arquivos CSV usam o símbolo pipe (|) para separar colunas

Estrutura da URL:

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

Parâmetros da Requisição:

access_name - access_name - seu identificador de subdomínio atribuído
date - date - data alvo no formato yyyy-mm-dd (ex: 2025-09-06)
file_name - 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 de API 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

Comando de Download Wget

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

Che168.com

Os anúncios do Che168.com contêm dados estruturados de veículos, incluindo especificações, preços, informações do vendedor e detalhes de localização. Esses dados mostram tendências de mercado, padrões de preços e comportamento do comprador em todo o mercado automotivo da China.

Históricos de veículos, relatórios de inspeção e dados de financiamento da plataforma fornecem conjuntos de dados detalhados. As empresas usam esses dados para planejamento de estoque, decisões de preços e estratégia de mercado.

Equipes de pesquisa de mercado, desenvolvedores de aplicativos automotivos e analistas de tendências acessam esses dados através da API Che168. O acesso direto a dados remove a necessidade de desenvolvimento e manutenção de scraper personalizado.

API Che168 opera continuamente, detecta novos anúncios em minutos e monitora mudanças de preço para dados de mercado em tempo real. Dados automotivos disponíveis via endpoints de API estruturados, sem scraping complexo.

Outros Dados Automotivos

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

🇦🇪

Dubizzle API

UAE dados automotivos API

🇪🇺

AutoScout24 API

Europe dados automotivos API

🇩🇪

Mobile.de API

Germany dados automotivos API

🇦🇪