Skip to main content
POST
Buscar itens por valor em uma lista

Visão geral

Busca itens dentro de uma lista específica (UUID). Usa primary_value e search_keys, com normalização sem acentos alinhada às outras buscas. value pode ser string (uma agulha) ou array de strings (até 50; duplicatas removidas após normalizar). Semântica OR: o item aparece no máximo uma vez se coincidir com qualquer agulha.
  • exact (padrão): igualdade normalizada com o primary ou com alguma chave.
  • contains: subcadeia no primary ou em alguma chave.
Por padrão só itens is_active: true; use includeInactive: true para incluir inativos.

Endpoint

Autenticação

Corpo da solicitação

string | string[]
required
Uma agulha (string, 1–4000) ou até 50 agulhas (string[], cada 1–4000). Strings vazias após trim são ignoradas; duplicatas colapsam após normalizar acentos.
string
default:"exact"
exact ou contains.
number
default:"100"
Máximo de linhas (1–500). truncated indica se há mais resultados que limit.
boolean
default:"false"
Com true, inclui itens inativos.

Exemplos

Um valor
Vários valores (OR)

Resposta

Inclui data.valuesSearched (número de agulhas distintas após deduplicar), além de items, total, returned, truncated, matchMode, listId — mesmo formato snake_case de Listar itens.

Ver também