{"openapi":"3.0.3","info":{"title":"FIPE API BRASIL","version":"1.1.0","description":"Consultas FIPE, histórico, comparação e metadados de imagens. Rotas também disponíveis com prefixo /api. Use X-API-Key para integração direta. No RapidAPI, use as credenciais fornecidas pelo marketplace; o segredo do proxy é exclusivo do servidor."},"servers":[{"url":"https://fipeapibrasil.com.br","description":"Servidor principal"}],"tags":[{"name":"Referências","description":"Referências da API FIPE e Mercado"},{"name":"Catálogo","description":"Catálogo da API FIPE e Mercado"},{"name":"Preços","description":"Preços da API FIPE e Mercado"},{"name":"Histórico","description":"Histórico da API FIPE e Mercado"},{"name":"Comparação","description":"Comparação da API FIPE e Mercado"},{"name":"Mídia","description":"Mídia da API FIPE e Mercado"},{"name":"Mercado (FENABRAVE)","description":"Mercado (FENABRAVE) da API FIPE e Mercado"}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Chave individual obtida no painel. Nunca coloque chave master no aplicativo."}},"schemas":{"Erro":{"type":"object","description":"Formato varia conforme a rota; examine o status HTTP e os campos presentes.","properties":{"error":{"type":"string"},"detail":{"type":"string"},"message":{"type":"string"},"mensagem":{"type":"string"},"retry_after":{"type":"integer"}}},"Referencia":{"type":"object","properties":{"codigo":{"type":"integer"},"mes":{"type":"string"}}},"Midia":{"type":"object","properties":{"foto_principal":{"type":"string","description":"URL HTTPS ou caminho /veiculos/. Ausente quando não há imagem segura."},"thumb":{"type":"string"},"galeria":{"type":"array","items":{"type":"string"}},"fonte":{"type":"string"},"correspondencia":{"type":"string","enum":["codigo_fipe","modelo"]},"precisao":{"type":"string","enum":["versao","familia","ilustrativa","sem_imagem"]},"revisao":{"type":"string","enum":["aprovada","pendente","rejeitada"]},"motivo":{"type":"string"},"placeholder_url":{"type":"string"},"ano_inicio":{"type":"integer","nullable":true},"ano_fim":{"type":"integer","nullable":true},"geracao":{"type":"string"},"carroceria":{"type":"string"},"fonte_url":{"type":"string"},"licenca":{"type":"string"},"autor":{"type":"string"},"licenca_url":{"type":"string"},"revisado_em":{"type":"string","format":"date-time"}}},"Cotacao":{"type":"object","description":"Registro do D1; campos adicionais podem existir. foto/midia são opcionais.","properties":{"codigo_fipe":{"type":"string"},"marca":{"type":"string"},"modelo":{"type":"string"},"ano":{"type":"string"},"tipo_veiculo":{"type":"integer"},"combustivel":{"type":"string"},"valor":{"type":"number"},"valor_texto":{"type":"string"},"referencia":{"type":"integer"},"mes_referencia":{"type":"string"},"foto":{"type":"string"},"midia":{"$ref":"#/components/schemas/Midia"}}},"Historico":{"type":"object","properties":{"referencia":{"type":"integer"},"mes":{"type":"string"},"valor":{"type":"string","description":"Valor formatado em reais, por exemplo R$ 85.000,00."}}},"Logo":{"type":"object","properties":{"marca":{"type":"string"},"marca_normalizada":{"type":"string"},"tipo_veiculo":{"type":"integer"},"logo_url":{"type":"string","nullable":true},"logo_svg_url":{"type":"string","nullable":true}}},"VeiculoComparacao":{"type":"object","required":["codigo_fipe"],"properties":{"codigo_fipe":{"type":"string"},"ano":{"type":"string"}}},"Evolucao":{"type":"object","properties":{"codigo_fipe":{"type":"string"},"marca":{"type":"string"},"modelo":{"type":"string"},"ano":{"type":"string"},"preco_inicial":{"type":"number"},"preco_atual":{"type":"number"},"desvalorizacao_percentual":{"type":"number"},"desvalorizacao_nominal":{"type":"number"},"pontos_historicos":{"type":"integer"},"tendencia":{"type":"string","enum":["valorizacao","desvalorizacao","estavel"]},"curva_desvalorizacao":{"type":"array","items":{"type":"object"}}}},"Comparacao":{"type":"object","properties":{"sucesso":{"type":"boolean"},"provedor":{"type":"string"},"meses_solicitados":{"type":"integer"},"data_analise":{"type":"string","format":"date-time"},"referencia_atual":{"$ref":"#/components/schemas/Referencia"},"veiculo1":{"$ref":"#/components/schemas/Evolucao"},"veiculo2":{"$ref":"#/components/schemas/Evolucao"},"comparativo":{"type":"object","properties":{"veiculo_menor_desvalorizacao":{"type":"string"},"codigo_fipe_vencedor":{"type":"string"},"vantagem_retencao_pontos_percentuais":{"type":"number"},"diferenca_nominal_reais":{"type":"number"},"diferenca_nominal_formatada":{"type":"string"},"analise_mercado":{"type":"string"}}}}},"RankingItem":{"type":"object","properties":{"posicao":{"type":"integer","example":1},"modelo":{"type":"string","example":"POLO"},"unidades":{"type":"integer","example":9066},"participacao_no_top":{"type":"string","example":"9.40%"}}},"MaisVendidos":{"type":"object","properties":{"sucesso":{"type":"boolean"},"fonte":{"type":"string"},"periodo":{"type":"object","properties":{"ano":{"type":"integer"},"mes":{"type":"integer"},"referencia":{"type":"string"},"status":{"type":"string"},"tipo_atualizacao":{"type":"string"},"atualizado_em":{"type":"string"}}},"segmento":{"type":"object","properties":{"id":{"type":"integer"},"slug":{"type":"string"},"nome":{"type":"string"},"icone":{"type":"string"}}},"total_veiculos":{"type":"integer"},"total_unidades_registradas":{"type":"integer"},"ranking":{"type":"array","items":{"$ref":"#/components/schemas/RankingItem"}}}},"Segmento":{"type":"object","properties":{"id":{"type":"integer"},"slug":{"type":"string"},"nome":{"type":"string"},"icone":{"type":"string"},"exemplo_requisicao":{"type":"string"}}},"HistoricoVendas":{"type":"object","properties":{"sucesso":{"type":"boolean"},"modelo_pesquisado":{"type":"string"},"total_registros_meses":{"type":"integer"},"total_unidades_acumuladas":{"type":"integer"},"historico":{"type":"array","items":{"type":"object"}}}}}},"paths":{"/referencia_atual":{"get":{"operationId":"get__referencia_atual","tags":["Referências"],"summary":"Referência mais recente no banco","description":"Referência mais recente no banco","parameters":[],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Referencia"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/referencias":{"get":{"operationId":"get__referencias","tags":["Referências"],"summary":"Listar referências disponíveis","description":"Listar referências disponíveis","parameters":[],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Referencia"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/marcas":{"get":{"operationId":"get__marcas","tags":["Catálogo"],"summary":"Listar marcas","description":"Listar marcas","parameters":[{"name":"tipo_veiculo","in":"query","required":true,"schema":{"type":"string","enum":["1","2","3","carros","motos","caminhoes"]},"description":"Categoria do veículo."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/modelos":{"get":{"operationId":"get__modelos","tags":["Catálogo"],"summary":"Listar modelos de uma marca","description":"Listar modelos de uma marca","parameters":[{"name":"tipo_veiculo","in":"query","required":true,"schema":{"type":"string","enum":["1","2","3","carros","motos","caminhoes"]},"description":"Categoria do veículo."},{"name":"marca","in":"query","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/anos":{"get":{"operationId":"get__anos","tags":["Catálogo"],"summary":"Listar anos de um modelo","description":"Listar anos de um modelo","parameters":[{"name":"tipo_veiculo","in":"query","required":true,"schema":{"type":"string","enum":["1","2","3","carros","motos","caminhoes"]},"description":"Categoria do veículo."},{"name":"marca","in":"query","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"modelo","in":"query","required":true,"schema":{"type":"string"},"description":"Nome retornado por /modelos; codifique caracteres especiais na URL."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/marcas/logos":{"get":{"operationId":"get__marcas_logos","tags":["Mídia"],"summary":"Listar logotipos das marcas","description":"Aceita também tipo. Sem tipo, retorna todas as categorias.","parameters":[{"name":"tipo_veiculo","in":"query","required":false,"schema":{"type":"string","enum":["1","2","3","carros","motos","caminhoes"]},"description":"Categoria do veículo."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"object","properties":{"sucesso":{"type":"boolean"},"total":{"type":"integer"},"tipo_veiculo":{"type":"string"},"marcas":{"type":"array","items":{"$ref":"#/components/schemas/Logo"}}}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/preco/{codigo_fipe}":{"get":{"operationId":"get__preco_codigo_fipe_","tags":["Preços"],"summary":"Cotações por código FIPE","description":"Retorna até 20 registros ordenados por ano decrescente. Nos planos basico, starter, pro, ultra (legado), enterprise, master e RapidAPI, midia descreve precisão, revisão e cobertura por ano. foto só aparece quando há imagem segura para a associação. Na ausência, midia.precisao=sem_imagem e placeholder_url informa uma ilustração neutra. Free e anônimo não recebem mídia. Imagens não revisadas são ilustrativas: não comprovam ano, versão ou cor. URLs públicas.","parameters":[{"name":"codigo_fipe","in":"path","required":true,"schema":{"type":"string","example":"002182-2"},"description":"Código FIPE do modelo."},{"name":"ano","in":"query","required":false,"schema":{"type":"string"},"description":"Valor retornado por /anos. Quatro dígitos podem corresponder a mais de um combustível."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Cotacao"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/valor":{"get":{"operationId":"get__valor","tags":["Preços"],"summary":"Consultar cotação por parâmetros","description":"Envie codigo_fipe (alias fipe) para obter uma lista de até 20 cotações, OU tipo_veiculo + marca + modelo para um objeto. Ano opcional. Aliases: tipo, codigo_marca, codigo_modelo. A busca por nome aceita aproximações; prefira o código FIPE. Nos planos basico, starter, pro, ultra (legado), enterprise, master e RapidAPI, midia descreve precisão, revisão e cobertura por ano. foto só aparece quando há imagem segura para a associação. Na ausência, midia.precisao=sem_imagem e placeholder_url informa uma ilustração neutra. Free e anônimo não recebem mídia. Imagens não revisadas são ilustrativas: não comprovam ano, versão ou cor. URLs públicas.","parameters":[{"name":"codigo_fipe","in":"query","required":false,"schema":{"type":"string","example":"002182-2"},"description":"Código FIPE do modelo."},{"name":"tipo_veiculo","in":"query","required":false,"schema":{"type":"string","enum":["1","2","3","carros","motos","caminhoes"]},"description":"Categoria do veículo."},{"name":"marca","in":"query","required":false,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"modelo","in":"query","required":false,"schema":{"type":"string"},"description":"Nome retornado por /modelos; codifique caracteres especiais na URL."},{"name":"ano","in":"query","required":false,"schema":{"type":"string"},"description":"Valor retornado por /anos. Quatro dígitos podem corresponder a mais de um combustível."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Cotacao"},{"type":"array","items":{"$ref":"#/components/schemas/Cotacao"}}]}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/preco":{"get":{"operationId":"get__preco","tags":["Preços"],"summary":"Consultar cotação por parâmetros","description":"Envie codigo_fipe (alias fipe) para obter uma lista de até 20 cotações, OU tipo_veiculo + marca + modelo para um objeto. Ano opcional. Aliases: tipo, codigo_marca, codigo_modelo. A busca por nome aceita aproximações; prefira o código FIPE. Nos planos basico, starter, pro, ultra (legado), enterprise, master e RapidAPI, midia descreve precisão, revisão e cobertura por ano. foto só aparece quando há imagem segura para a associação. Na ausência, midia.precisao=sem_imagem e placeholder_url informa uma ilustração neutra. Free e anônimo não recebem mídia. Imagens não revisadas são ilustrativas: não comprovam ano, versão ou cor. URLs públicas.","parameters":[{"name":"codigo_fipe","in":"query","required":false,"schema":{"type":"string","example":"002182-2"},"description":"Código FIPE do modelo."},{"name":"tipo_veiculo","in":"query","required":false,"schema":{"type":"string","enum":["1","2","3","carros","motos","caminhoes"]},"description":"Categoria do veículo."},{"name":"marca","in":"query","required":false,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"modelo","in":"query","required":false,"schema":{"type":"string"},"description":"Nome retornado por /modelos; codifique caracteres especiais na URL."},{"name":"ano","in":"query","required":false,"schema":{"type":"string"},"description":"Valor retornado por /anos. Quatro dígitos podem corresponder a mais de um combustível."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Cotacao"},{"type":"array","items":{"$ref":"#/components/schemas/Cotacao"}}]}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/historico":{"get":{"operationId":"get__historico","tags":["Histórico"],"summary":"Histórico de preços","description":"Sem paginação; ordenado por referência crescente. Não aplica ?referencia. Ano abreviado pode agregar combustíveis.","parameters":[{"name":"codigo_fipe","in":"query","required":true,"schema":{"type":"string","example":"002182-2"},"description":"Código FIPE do modelo."},{"name":"ano","in":"query","required":true,"schema":{"type":"string"},"description":"Valor retornado por /anos. Quatro dígitos podem corresponder a mais de um combustível."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Historico"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/historico/{codigo_fipe}/{ano}":{"get":{"operationId":"get__historico_codigo_fipe_ano_","tags":["Histórico"],"summary":"Histórico de preços","description":"Sem paginação; ordenado por referência crescente. Não aplica ?referencia. Ano abreviado pode agregar combustíveis.","parameters":[{"name":"codigo_fipe","in":"path","required":true,"schema":{"type":"string","example":"002182-2"},"description":"Código FIPE do modelo."},{"name":"ano","in":"path","required":true,"schema":{"type":"string"},"description":"Valor retornado por /anos. Quatro dígitos podem corresponder a mais de um combustível."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Historico"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/filtrar":{"get":{"operationId":"get__filtrar","tags":["Preços"],"summary":"Filtrar por faixa de preço","description":"Ordenado por valor decrescente. valor_max deve ser >= valor_min. Não enriquece com imagens. Cabeçalhos X-Pagination-Limit e X-Pagination-Max-Allowed indicam o limite efetivo.","parameters":[{"name":"tipo_veiculo","in":"query","required":true,"schema":{"type":"string","enum":["1","2","3","carros","motos","caminhoes"]},"description":"Categoria do veículo."},{"name":"valor_min","in":"query","required":true,"schema":{"type":"number","minimum":0},"description":""},{"name":"valor_max","in":"query","required":true,"schema":{"type":"number","minimum":0},"description":""},{"name":"marcas","in":"query","required":false,"schema":{"type":"string"},"description":"Nomes completos separados por vírgula; comparação sem distinção de maiúsculas."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Teto: 20 Free/anônimo; 50 Básico/Starter; 100 Pro/Enterprise/master/RapidAPI. Não há offset."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Cotacao"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/comparar":{"get":{"operationId":"get__comparar","tags":["Comparação"],"summary":"Comparar evolução de dois veículos","description":"Exclusivo para planos pagos e RapidAPI. Compara até 24 pontos de referências disponíveis; lacunas não são interpoladas. Valores positivos representam valorização, negativos desvalorização. Sem ?referencia. Nomes podem selecionar um modelo aproximado. Usa 12 quando meses é inválido/menor que 2; limita a 24.","parameters":[{"name":"veiculo1","in":"query","required":true,"schema":{"type":"string"},"description":"Código FIPE ou nome do primeiro modelo."},{"name":"veiculo2","in":"query","required":true,"schema":{"type":"string"},"description":"Código FIPE ou nome do segundo modelo."},{"name":"ano1","in":"query","required":false,"schema":{"type":"string"},"description":""},{"name":"ano2","in":"query","required":false,"schema":{"type":"string"},"description":""},{"name":"meses","in":"query","required":false,"schema":{"type":"integer","minimum":2,"maximum":24,"default":12},"description":""}],"security":[{"ApiKey":[]}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comparacao"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}},"post":{"operationId":"post__comparar","tags":["Comparação"],"summary":"Comparar usando JSON","description":"Exclusivo para planos pagos e RapidAPI. Compara até 24 pontos de referências disponíveis; lacunas não são interpoladas. Valores positivos representam valorização, negativos desvalorização. Sem ?referencia. Nomes podem selecionar um modelo aproximado. Usa 12 quando meses é inválido/menor que 2; limita a 24.","parameters":[],"security":[{"ApiKey":[]}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comparacao"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["veiculo1","veiculo2"],"properties":{"veiculo1":{"$ref":"#/components/schemas/VeiculoComparacao"},"veiculo2":{"$ref":"#/components/schemas/VeiculoComparacao"},"meses":{"type":"integer","minimum":2,"maximum":24,"default":12}}},"example":{"veiculo1":{"codigo_fipe":"002182-2","ano":"2024"},"veiculo2":{"codigo_fipe":"004451-2","ano":"2014"},"meses":12}}}}}},"/mercado/mais-vendidos":{"get":{"operationId":"get__mercado_mais_vendidos","tags":["Mercado (FENABRAVE)"],"summary":"Ranking de mais vendidos por segmento (FENABRAVE)","description":"Retorna o Top 20 veículos mais vendidos no Brasil segundo a FENABRAVE com cálculo de market share no segmento. No mês corrente, possui acompanhamento com atualização frequente.","parameters":[{"name":"segmento","in":"query","required":false,"schema":{"type":"string","enum":["auto","motos","comercial","caminhoes","onibus","implementos","todos","1","2","3","4","6","7"]},"description":"Categoria de mercado. Padrão: auto (Automóveis)."},{"name":"ano","in":"query","required":false,"schema":{"type":"integer","minimum":2024,"maximum":2030},"description":"Ano da apuração. Padrão: ano mais recente."},{"name":"mes","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":12},"description":"Mês da apuração (1 a 12). Padrão: mês mais recente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaisVendidos"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/mercado/mais-vendidos/atual":{"get":{"operationId":"get__mercado_mais_vendidos_atual","tags":["Mercado (FENABRAVE)"],"summary":"Visão consolidada do mês atual de todos os segmentos","description":"Retorna os rankings consolidados de todos os 7 segmentos do mercado automotivo nacional em uma só chamada.","parameters":[],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/mercado/segmentos":{"get":{"operationId":"get__mercado_segmentos","tags":["Mercado (FENABRAVE)"],"summary":"Listar categorias e segmentos da FENABRAVE","description":"Retorna os 7 segmentos monitorados (Automóveis, Comerciais Leves, Motos, Caminhões, Ônibus, Implementos e Geral).","parameters":[],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"object","properties":{"sucesso":{"type":"boolean"},"total":{"type":"integer"},"segmentos":{"type":"array","items":{"$ref":"#/components/schemas/Segmento"}}}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/mercado/historico":{"get":{"operationId":"get__mercado_historico","tags":["Mercado (FENABRAVE)"],"summary":"Evolução histórica de emplacamentos de um modelo","description":"Retorna a série temporal de vendas mês a mês desde 2024 para o modelo especificado (ex: ?modelo=POLO).","parameters":[{"name":"modelo","in":"query","required":true,"schema":{"type":"string"},"description":"Nome do modelo para busca de histórico de vendas (ex: POLO, STRADA, CG 160)."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoricoVendas"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/tabela/{tipo}":{"get":{"operationId":"get__tabela_tipo_","tags":["Catálogo"],"summary":"Listar marcas (alias)","description":"Alias de /marcas. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/marcas/{tipo}":{"get":{"operationId":"get__marcas_tipo_","tags":["Catálogo"],"summary":"Listar marcas (alias)","description":"Alias de /marcas. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/{tipo}/marcas":{"get":{"operationId":"get__tipo_marcas","tags":["Catálogo"],"summary":"Listar marcas (alias)","description":"Alias de /marcas. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/tabela/{tipo}/marca/{marca}":{"get":{"operationId":"get__tabela_tipo_marca_marca_","tags":["Catálogo"],"summary":"Listar modelos de uma marca (alias)","description":"Alias de /modelos. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"marca","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/modelos/{tipo}/{marca}":{"get":{"operationId":"get__modelos_tipo_marca_","tags":["Catálogo"],"summary":"Listar modelos de uma marca (alias)","description":"Alias de /modelos. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"marca","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/{tipo}/marcas/{marca}/modelos":{"get":{"operationId":"get__tipo_marcas_marca_modelos","tags":["Catálogo"],"summary":"Listar modelos de uma marca (alias)","description":"Alias de /modelos. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"marca","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/{tipo}/modelos/{marca}":{"get":{"operationId":"get__tipo_modelos_marca_","tags":["Catálogo"],"summary":"Listar modelos de uma marca (alias)","description":"Alias de /modelos. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"marca","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/tabela/{tipo}/marca/{marca}/modelo/{modelo}":{"get":{"operationId":"get__tabela_tipo_marca_marca_modelo_modelo_","tags":["Catálogo"],"summary":"Listar anos de um modelo (alias)","description":"Alias de /anos. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"marca","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"modelo","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /modelos; codifique caracteres especiais na URL."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/anos/{tipo}/{marca}/{modelo}":{"get":{"operationId":"get__anos_tipo_marca_modelo_","tags":["Catálogo"],"summary":"Listar anos de um modelo (alias)","description":"Alias de /anos. Aceita nomes de categorias: carros, motos, caminhoes ou 1, 2, 3.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"marca","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"modelo","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /modelos; codifique caracteres especiais na URL."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/tabela/{tipo}/marca/{marca}/modelo/{modelo}/ano/{ano}":{"get":{"operationId":"get__tabela_tipo_marca_marca_modelo_modelo_ano_ano_","tags":["Preços"],"summary":"Cotação por caminho completo","description":"Busca flexível por nome e ano. Nos planos basico, starter, pro, ultra (legado), enterprise, master e RapidAPI, midia descreve precisão, revisão e cobertura por ano. foto só aparece quando há imagem segura para a associação. Na ausência, midia.precisao=sem_imagem e placeholder_url informa uma ilustração neutra. Free e anônimo não recebem mídia. Imagens não revisadas são ilustrativas: não comprovam ano, versão ou cor. URLs públicas.","parameters":[{"name":"tipo","in":"path","required":true,"schema":{"type":"string"},"description":"Componente da rota; enviar codificado na URL."},{"name":"marca","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /marcas. IDs legados só possuem mapeamento parcial."},{"name":"modelo","in":"path","required":true,"schema":{"type":"string"},"description":"Nome retornado por /modelos; codifique caracteres especiais na URL."},{"name":"ano","in":"path","required":true,"schema":{"type":"string"},"description":"Valor retornado por /anos. Quatro dígitos podem corresponder a mais de um combustível."},{"name":"referencia","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Código de /referencias. Padrão: maior código disponível no banco; não necessariamente o mês corrente."}],"security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"Consulta concluída","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cotacao"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Cota do período"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Saldo estimado"},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Texto da renovação em UTC"}}},"400":{"description":"Parâmetros incompletos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Autenticação/origem recusada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Chave inválida ou plano sem acesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Parâmetro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota ou limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"500":{"description":"Falha interna","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}