O que é a API Guazi e como funciona?

Conecte-se ao maior marketplace chinês de carros usados através da nossa API. Obtenha dados automotivos organizados via endpoints REST. Acompanhe veículos certificados, mudanças de preços e vendas em tempo real.

Quais dados do Guazi a API fornece?

Informações completas sobre veículos: marca, modelo, preço, quilometragem, status de certificação, relatórios de inspeção, histórico de acidentes e fotos profissionais de todos os anúncios Guazi.

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

Fluxo contínuo de dados. Novos anúncios de carros usados detectados em minutos. Arquivos diários incluem todos os veículos certificados ativos e recentemente vendidos.

Quais formatos a API Guazi suporta?

Múltiplos formatos: API REST para atualizações em tempo real, JSON para dados estruturados, CSV para análises e Excel para relatórios empresariais. Todos os formatos incluem detalhes completos de inspeção e certificação.

O que é a inspeção de 259 pontos incluída nos dados?

Cada anúncio Guazi inclui resultados de sua inspeção profissional abrangente de 259 pontos. A API fornece status de inspeção, relatórios detalhados e níveis de certificação para cada veículo.

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.

Posso acessar o histórico completo de acidentes através da API?

Sim, todos os anúncios incluem relatórios completos do histórico de acidentes. Os dados mostram danos anteriores, registros de reparos e status de certificação baseados no processo de verificação da Guazi.

Guazi APIScraper e Parser

Acesse dados certificados de carros usados da maior plataforma da China via API. Relatórios de inspeção de 259 pontos, histórico de acidentes, inventário em tempo real sem scrapers.

API Plataforma de Carros Usados Guazi

Acesse o principal marketplace chinês de carros usados certificados através da nossa API. Obtenha dados limpos de Xangai, Pequim e grandes cidades chinesas para análise de mercado e gestão de inventário.

API ao Vivo

Receba alertas instantâneos para novos anúncios de carros usados certificados.

Exportações Diárias

Exportação diária de todos os carros certificados ativos para rastreamento de mercado.

Parser de Dados

Acesse dados abrangentes de carros usados: preço, especificações, relatórios de inspeção, status de certificação, histórico de acidentes, detalhes de garantia de cada anúncio.

Obter Acesso à APIAcesso fornecido em 2 minutos

API

URL Base

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

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

Como integrar efetivamente:

1. Primeiro, use /offers para recuperar todo o conjunto de dados (pagine por todos os resultados)

2. Em seguida, consulte /changes periodicamente para obter todas as atualizações (registros novos/atualizados/removidos) para sincronizar seu banco de dados local com a fonte

3. Para integração front-end, use /offers com filtros específicos e paginação (marca, modelo, faixa de preço, ano, etc.)

GET/filters

Retorna todos os valores possíveis para filtragem

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

Resposta:

{
  "mark": {
    "BMW": { "model": ["X5", "X3"] },
    "Audi": { "model": ["A4", "Q7"] }
  },
  "transmission_type": ["MT", "AT"],
  "color": ["Green", "Purple", "Red", "White", "Champagne", "Silver", "Black", "Gray", "Blue", "Yellow"],
  "rudder": ["Left"],
  "body_type": ["Sedan", "Station Wagon", "SUV", "Convertible", "Bus", "Sports Car", "Hatchback", "Pick Up", "Crossover", "Truck"],
  "engine_type": ["Diesel", "PHEV", "HEV", "Gasoline", "BEV", "REEV"],
  "drive_type": ["4WD", "2WD"]
}

GET/offers

Lista de listagens com paginação e filtros

Parâmetros:

page (obrigatório) - número da página
mark, model, transmission_type, color, rudder, body_type, engine_type, drive_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/guazi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/guazi/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=black

Resposta:

{
  "result": [
    {
      "id": 3847521,
      "inner_id": "152471636",
      "change_type": "added",
      "created_at": "2025-10-28T14:28:35.620Z",
      "data": {
        "id": 5269,
        "inner_id": "152471636",
        "url": "https://www.guazi.com/binzhou/auto/152471636.htm",
        "title": "Haval H2 2016 1.5T AT",
        "mark": "Haval",
        "model": "H2",
        "full_model": "H2 1.5T Automatic Elite",
        "transmission_type": "AT",
        "year": 2016,
        "km_age": 112700,
        "price": 5011,
        "color": "Black",
        "displacement": 1.5,
        "doors_count": 5,
        "region": "China",
        "city": "Binzhou",
        "address": "Binzhou, Shandong",
        "section": "used",
        "rudder": "Left",
        "body_type": "SUV",
        "engine_type": "Gasoline",
        "equipment": ["Heated Seats", "Keyless Entry", "Backup Camera"],
        "images": ["https://global-image-pub.guazistatic.com/qnbdp7206x..."],
        "extra": {"inspection_score": 85},
        "drive_type": "2WD",
        "productionYearMonth": "2016-03",
        "licenseDate": "2016-05-20"
      }
    }
  ],
  "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
title - título da listagem
mark - marca do carro
model - modelo do carro
full_model - nome completo do modelo
transmission_type - tipo de transmissão (AT/MT)
year - ano de produção
km_age - quilometragem em km
price - preço em CNY
color - cor
displacement - cilindrada do motor

doors_count - número de portas
region - região
city - cidade
address - endereço
section - seção
rudder - posição do volante (esquerda/direita)
body_type - tipo de carroceria
engine_type - tipo de motor
equipment - lista de equipamentos
images - array de URLs de imagens
drive_type - tipo de tração (FWD/RWD/AWD)
productionYearMonth - data de produção (ano-mês)
licenseDate - data de registro

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/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Resposta:

{ "change_id": 6718293 }

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/guazi/changes?api_key=YOUR_API_KEY&change_id=1

Resposta:

{
  "result": [
    {
      "id": 456,
      "inner_id": "152471636",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "152471637",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 4800 }
    },
    {
      "id": 458,
      "inner_id": "152471638",
      "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/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636

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

Exportações Diárias para Guazi.com

Protocolo de Armazenamento de Dados

Arquivos são armazenados por mais de 3 dias.

Cronograma de Entrega da API

Arquivos diários estão prontos para download.

Configuração de Arquivo CSV

Arquivos CSV usam barra vertical (|) como separador de colunas.

Estrutura de URL:

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

Parâmetros de Solicitação:

access_name - access_name - seu identificador de subdomínio atribuído
date - date - data alvo no formato aaaa-mm-dd (ex. 2025-09-22)
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 Solicitação 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'

Guazi.com

A Guazi é a maior plataforma de carros usados certificados da China. Criada para trazer transparência real ao mercado de seminovos, ela conecta compradores a veículos de qualidade comprovada nas principais cidades chinesas. Todo carro passa por uma rigorosa inspeção profissional de 259 pontos antes de ser publicado.

Cada anúncio traz relatórios detalhados de inspeção, histórico completo de acidentes, fotos profissionais e preços transparentes. O processo de certificação da Guazi assegura que os compradores tenham acesso a informações precisas sobre cada veículo - incluindo problemas ocultos e todo o histórico de manutenção.

A plataforma disponibiliza financiamento, garantias estendidas e suporte completo pós-venda. Com filtros de busca avançados, os compradores encontram facilmente o carro ideal filtrando por marca, modelo, ano, faixa de preço, quilometragem e nível de certificação. O inventário é atualizado em tempo real para manter todos os anúncios sempre atuais.

Nossa API entrega dados estruturados do marketplace Guazi por meio de endpoints estáveis e confiáveis. Integre o inventário completo de carros usados certificados nas suas aplicações para análise de preços, pesquisa de mercado e gestão automatizada do estoque.

Nossa API em tempo real funciona 24/7, detectando novos anúncios certificados em poucos minutos e rastreando veículos vendidos para revelar os preços reais de transação. Acesse dados completos de inspeção e certificação sem precisar criar scrapers personalizados.

Outros Dados Automotivos

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

🇰🇷

Encar API

Korea dados do mercado de carros API

🇨🇳

Che168 API

China dados automotivos API

🇨🇳

Dongchedi API

China dados automotivos API

🇦🇪