Documentação | AUTO-API.COM

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 'from_id'. Comece com from_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.

Campos de Dados Disponíveis

A API dá acesso a pontos de dados completos, incluindo:

Atributos Principais do Veículo

  • Marca & Modelo
  • Ano & Geração
  • Acabamento & Configuração
  • Estilo da Carroceria
  • Cor Externa

Especificações Técnicas

  • Tipo de Motor & Cilindrada
  • Potência
  • Transmissão
  • Tração
  • Leitura do Odômetro

Dados de Anúncio do Marketplace

  • Preço & Moeda
  • URL & ID do Anúncio
  • Disponibilidade
  • Data de Publicação
  • Descrição Completa

Detalhes do Vendedor & Localização

  • Região & Cidade
  • Tipo de Vendedor (Revendedor/Particular)
  • Informações de Contato
  • Histórico do Veículo
  • Fotos & Opções

* A disponibilidade do campo de dados varia de acordo com o marketplace de origem e a integridade do anúncio.

Exportações Diárias de Dados

Retenção de Dados

Mantemos seus arquivos seguros por no mínimo 3 dias + arquivo automatizado.

Disponibilidade de Exportação

Exportações diárias de dados com conteúdo atualizado disponíveis para download a cada dia.

Detalhes do Formato CSV

Arquivos CSV empregam o delimitador pipe (|) como separador de coluna padrão em todos os conjuntos de dados.

Estrutura da URL:

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

Parâmetros da Requisição:

  • personal_name - seu identificador de subdomínio único atribuído.
  • date - data alvo para os dados no formato yyyy-mm-dd (ex: 2025-09-06).
  • file_name - nome do arquivo de exportação, incluindo sua extensão.

Formatos Disponíveis:

  • CSV - CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

Exemplo de Requisição de API cURL

curl -L -X GET 'https://{personal_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://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Documentação da API em Tempo Real

Parâmetros da Requisição da API

api_key - Sua chave de API única para autenticação.

from_id - O ID de Mudança para buscar dados. Use 0 para a requisição inicial, depois o último ID recebido + 1.

Campos da Resposta da API

inner_id - O ID permanente e único do anúncio no marketplace de origem.

change_type - O tipo de evento: "added", "changed" (ex: atualização de preço), ou "removed".

created_at - O timestamp que indica quando o evento ocorreu.

Exemplo de Corpo da Resposta

{
  "result": [
    {
      "id": 2664810,
      "inner_id": "40428521",
      "change_type": "added",
      "created_at": "2025-09-02T05:44:49.000",
      "data": {
        "id": "1455502",
        "inner_id": "40428521",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40428521",
        "mark": "Hyundai",
        "model": "Genesis",
        "generation": "200 Turbo S",
        "configuration": "200 Turbo S",
        "complectation": null,
        "year": "2012",
        "color": "Red",
        "price": "8900000",
        "km_age": "246400",
        "engine_type": "Gasoline",
        "transmission_type": "Manual",
        "body_type": "Sports Car",
        "address": "Busan Dongnae-gu",
        "seller_type": "REPEAT",
        "is_dealer": "false",
        "section": "used",
        "seller": "cainabel",
        "salon_id": "05062013358",
        "description": "I'm not a dealer; I'm an individual who loves cars...",
        "displacement": "1998.0",
        "offer_created": "2025-09-02T05:44:49.000",
        "manufacturerName": "Hyundai",
        "modelName": "The New Genesis Coupe",
        "gradeName": "200 Turbo S",
        "modelGroupName": "Genesis",
        "yearMonth": "201203",
        "images": [
          {
            "code": "001",
            "path": "/carpicture02/pic4042/40428521_001.JPG",
            "type": "OUTER"
          }
        ],
        "advertisementType": "NORMAL",
        "created_at": "2025-09-02T00:47:21.243",
        "extra": "{diagnosis:{...},inspection:{...},accidents:[...]}",
        "options": {
          "standard": [
            "001",
            "003",
            "006",
            "007",
            "008"
          ],
          "choice": [
            "1052"
          ],
          "tuning": [
            "015",
            "016",
            "017",
            "018",
            "021"
          ]
        }
      }
    },
    {
      "id": 2664811,
      "inner_id": "39969819",
      "change_type": "changed",
      "created_at": "2025-08-17T05:19:34.442",
      "data": {
        "new_price": 34900000
      }
    },
    {
      "id": 2664812,
      "inner_id": "39971229",
      "change_type": "removed",
      "created_at": "2025-08-17T05:19:39.778"
    }
  ],
  "meta": {
    "cur_from_id": "2664810",
    "limit": 10
  }
}