Busca

Busca veículos

Busca de texto completo por veículos com filtros e ordenação avançados.

Filtros Disponíveis:

  • model: UUID do modelo (=, !=, IN, NOT IN)
  • make: UUID da marca (=, !=, IN, NOT IN)
  • fuel: UUID do combustível (=, !=, IN, NOT IN)
  • type: UUID do tipo de veículo (=, !=, IN, NOT IN)
  • body_type: Slug da carroceria (=, !=, IN, NOT IN)
  • fipe_code: Código FIPE com hífen, ex. 811049-7 (= apenas, exatamente 8 chars)
  • year: Ano (=, !=, >, <, >=, <=, IN, TO; suporta "zero")
  • price: Preço em moeda corrente (>, <, >=, <=, TO; convertido para centavos)

Nota sobre CONTAINS: CONTAINS/NOT CONTAINS não são suportados em nenhum campo de /v1/search (incluindo body_type) e resultam em erro 400.

Inclui facets disjuntivos para make, model, fuel, type, body_type, year (distribuição) e price (estatísticas min/max).

Zero resultados retorna 200, não 404.

get/v1/search

Request

  • Base URL: https://api.fipex.com.br
  • URL: https://api.fipex.com.br/v1/search
  • Auth: none declared

Query parameters

pageinteger

Número da página (mínimo 1). Valores não inteiros ou fora do intervalo retornam 400 ValidationError.

limitinteger

Número de itens por página (1-50). Valores não inteiros ou fora do intervalo retornam 400 ValidationError.

string
OR
string[]
Example:name

Especificação de ordenação. Pode ser fornecida em múltiplos formatos:

Campo único: ?order_by=name (ascendente) ou ?order_by=-name (descendente)

Separado por vírgula: ?order_by=name,-price

Notação de array: ?order_by[]=name&order_by[]=-price

Use o prefixo - para ordem descendente.

qstring

Termo de busca livre. Palavras-chave como "zero km", "zero", "novo", "nova" são interpretadas como intenção de veículos 0km.

fieldstring required

Nome do campo para filtrar.

op'=' | '!=' | '>' | '<' | '>=' | '<=' | 'CONTAINS' | 'NOT CONTAINS' | 'IN' | 'NOT IN' | 'TO' | 'IS NULL' required

Operador do filtro.

valuestring

Valor do filtro (o tipo depende do campo e do operador). Para IN/NOT IN/TO use vírgula como separador.

negateboolean

Se deve negar a condição do filtro.

condition'AND' | 'OR'

Condição lógica para combinar com outros filtros.

Filtragem avançada usando notação de array. Cada filtro requer:

  • field: O campo a ser filtrado.
  • op: O operador (veja a seção Operadores de Filtro).
  • value: O valor para filtrar.

Formato: filters[0].field=year&filters[0].op=%3E&filters[0].value=2010

Múltiplos filtros: filters[0].field=year&filters[0].op=%3E&filters[0].value=2010&filters[1].field=price&filters[1].op=TO&filters[1].value=20000,50000

Response

Resultados da busca obtidos com sucesso (pode ser array vazio).

time_taken_msinteger required

Tempo de execução da busca em milissegundos.

Changes

No recorded changes to this operation across all 1 revision of this API.