# Tabela FIPE — Preço de Veículos (Carros, Motos, Caminhões) (`gangary/tabela-fipe`) Actor

Consulte a Tabela FIPE em lote: marca + modelo (+ano) ou codigo FIPE direto. Devolve valor atual, combustivel e mes de referencia para carros, motos e caminhoes. Fonte publica com fallback automatico. Ideal para revendas, seguradoras, financeiras e marketplaces automotivos.

- **URL**: https://apify.com/gangary/tabela-fipe.md
- **Developed by:** [Gangary](https://apify.com/gangary) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 per price founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

![tabela-fipe](https://empresas-por-cnae.vercel.app/covers/tabela-fipe.png)

## Tabela FIPE — Preço de Veículos (Carros, Motos, Caminhões)

Consulte o **preço médio FIPE em lote**: mande uma lista de veículos (marca + modelo + ano, ou o código FIPE direto) e receba o valor atual de tabela, o combustível e o mês de referência de cada um. Cobre **carros, motos e caminhões**.

Feito pra quem trabalha com veículo em volume: **revendas e lojistas** (precificar estoque), **seguradoras e financeiras** (valor de referência), **marketplaces** (validar anúncio) e **compradores profissionais** (achar carro abaixo da tabela).

### O que você recebe

Exemplo real de saída:

```json
{
  "consulta": "Volkswagen Amarok 2014",
  "found": true,
  "marca": "VW - VolksWagen",
  "modelo": "AMAROK High.CD 2.0 16V TDI 4x4 Dies. Aut",
  "anoModelo": 2014,
  "combustivel": "Diesel",
  "valor": "R$ 85.608,00",
  "valorNumerico": 85608,
  "codigoFipe": "005340-6",
  "mesReferencia": "agosto de 2026",
  "tipoVeiculo": "carros",
  "fonte": "parallelum",
  "error": null
}
```

| Campo | O que é |
|---|---|
| `consulta` | O que você pediu (eco do input) |
| `marca` / `modelo` / `anoModelo` | Veículo como consta na tabela FIPE |
| `valor` | Preço FIPE formatado |
| `valorNumerico` | O mesmo preço como número — pronto pra planilha e cálculo |
| `codigoFipe` | Código oficial FIPE do modelo |
| `mesReferencia` | Mês da tabela em vigor |
| `combustivel` | Diesel, Gasolina, Flex, Elétrico… |

**Dica:** sem o campo `ano`, o actor devolve o preço de **todos os anos** do modelo — perfeito pra montar a curva de depreciação de um veículo em uma consulta.

### Como usar

No campo **Consultas**, cada item é um objeto:

```json
[
  { "marca": "Volkswagen", "modelo": "Amarok", "ano": "2014" },
  { "codigoFipe": "005340-6" },
  { "marca": "Honda", "modelo": "CG 160", "tipo": "motos" }
]
```

- Por **nome**: `marca` + `modelo` (+ `ano` opcional). O matching é tolerante — "Volkswagen" acha "VW - VolksWagen".
- Por **código FIPE**: só `codigoFipe`.
- `tipo`: `carros` (default), `motos` ou `caminhoes`.

### Quanto custa

Taxa pequena de início + valor por **preço encontrado**.

| Cenário | Custo aproximado |
|---|---|
| 25 veículos (1 ano cada) | ~US$ 0,11 |
| 100 veículos | ~US$ 0,41 |
| 100 modelos com TODOS os anos (~10 preços cada) | ~US$ 4,00 |

### Perguntas frequentes

**A fonte é oficial?**
Os preços são os da Tabela FIPE vigente, servidos por API pública que espelha a tabela oficial, com fallback automático de fonte quando a primária está fora do ar.

**"Zero KM" funciona?**
Sim — informe `"ano": "32000"` (código FIPE para 0 km) ou omita o ano e pegue todos.

**E se eu errar o nome do modelo?**
O matching normaliza acento/caixa e aceita nome parcial. Se mesmo assim não achar, o registro volta com `error` dizendo exatamente o que não casou (marca, modelo ou ano) — você corrige só o que precisa.

### Limitações honestas

- O nome do modelo na FIPE é peculiar ("AMAROK High.CD 2.0 16V TDI 4x4 Dies. Aut") — em modelos com muitas versões, a busca por nome pega a versão de nome mais próximo. Pra precisão absoluta de versão, use o `codigoFipe`.
- Máximo de 200 consultas por execução.

### From the same maker

- **[Consulta CEP em Lote](https://apify.com/gangary/consulta-cep-lote)** — endereço completo por CEP, multi-fonte.
- **[Consulta CNPJ](https://apify.com/gangary/cnpj-lookup)** — dados cadastrais de empresas brasileiras.
- **[B2B Leads Brazil](https://apify.com/gangary/b2b-leads-brazil)** — leads B2B prontos com score.

***

*Palavras-chave: tabela FIPE, preço FIPE, consulta FIPE em lote, API tabela FIPE, valor de carro usado, preço de moto FIPE, código FIPE, depreciação de veículo, precificação de estoque de veículos.*

# Actor input Schema

## `consultas` (type: `array`):

Cada item: {"marca", "modelo", "ano"} para buscar por nome, OU {"codigoFipe"} para consulta direta. Campo opcional "tipo": carros (default), motos ou caminhoes. Sem "ano", devolve todos os anos do modelo.

## Actor input object example

```json
{
  "consultas": [
    {
      "marca": "Volkswagen",
      "modelo": "Amarok",
      "ano": "2014"
    },
    {
      "codigoFipe": "005340-6"
    }
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "consultas": [
        {
            "marca": "Volkswagen",
            "modelo": "Amarok",
            "ano": "2014"
        },
        {
            "codigoFipe": "005340-6"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("gangary/tabela-fipe").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "consultas": [
        {
            "marca": "Volkswagen",
            "modelo": "Amarok",
            "ano": "2014",
        },
        { "codigoFipe": "005340-6" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("gangary/tabela-fipe").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "consultas": [
    {
      "marca": "Volkswagen",
      "modelo": "Amarok",
      "ano": "2014"
    },
    {
      "codigoFipe": "005340-6"
    }
  ]
}' |
apify call gangary/tabela-fipe --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gangary/tabela-fipe"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jV5ICF6TW8wVWwGzg/builds/prWg3YwSasBJtvK0O/openapi.json