altis-fipe 0.1.0

Cliente oficial da Altis FIPE API — consulte a Tabela FIPE (carros, motos, caminhões) com uma chave de API.

altis-fipe

Cliente oficial Python da Altis FIPE API. Consulte a Tabela FIPE (carros, motos e caminhões).

Instalação

pip install altis-fipe

Pegue sua chave (grátis)

1. Crie a conta em https://fipe.altis.online/cadastro — você ganha 1.000 créditos de cortesia.
2. Copie a chave fpk_live_....
3. Exporte:

export ALTIS_FIPE_KEY="fpk_live_xxxxxxxxxxxx"

Uso

import os
from altis_fipe import AltisFipe

fipe = AltisFipe(api_key=os.environ["ALTIS_FIPE_KEY"])

brands = fipe.cars.brands()                       # 0 créditos
models = fipe.cars.models(56)
years = fipe.cars.years(56, 9984)
quote = fipe.cars.quote(brand_id=56, model_id=9984, year_id="2025-6")

print(quote["model"], quote["price"], quote["referenceMonth"])

Como context manager (fecha a conexão automaticamente):

with AltisFipe(api_key=os.environ["ALTIS_FIPE_KEY"]) as fipe:
    print(fipe.motorcycles.brands())

Tratamento de erros

from altis_fipe import AltisFipe, AltisFipeError

try:
    fipe.cars.quote(brand_id=56, model_id=9984, year_id="2025-6")
except AltisFipeError as err:
    if err.is_out_of_credits:
        print("Sem créditos.")
    elif err.is_rate_limited:
        print("Rate limit.")
    elif err.is_auth_error:
        print("Chave inválida.")
    else:
        print(err.code, err.message, err.details)

Combustível (year_id)

year_id segue o padrão YYYY-F: 1=Gasolina, 2=Álcool, 3=Diesel, 4=Flex, 5=Elétrico, 6=Híbrido.

Licença

Proprietária — Altis 2026.