Skip to main content
POST
Buscar ítems por valor en una lista

Resumen

Busca ítems dentro de una lista concreta (UUID). La comparación usa primary_value y cada search_keys, con la misma normalización sin acentos que el resto de búsquedas. Podés enviar value como string (una aguja) o como array de strings (hasta 50 entradas; se eliminan duplicados tras normalizar). La semántica es OR: cualquier ítem que coincida con cualquiera de las agujas aparece como máximo una vez en items.
  • exact (por defecto): igualdad normalizada con el primary o con alguna clave.
  • contains: subcadena en el primary o en alguna clave (LIKE con %/_ escapados en la aguja).
Por defecto solo ítems is_active: true; con includeInactive: true se incluyen inactivos.

Endpoint

Autenticación

Cuerpo de la solicitud

string | string[]
required
Una aguja (string, 1–4000 caracteres) o hasta 50 agujas (string[], cada una 1–4000). Se ignoran strings vacíos tras trim; los duplicados colapsan tras normalizar acentos. Tiene que quedar al menos una aguja no vacía.
string
default:"exact"
exact o contains.
number
default:"100"
Máximo de filas devueltas (1–500). Si hay más coincidencias, truncated es true y total es el conteo total.
boolean
default:"false"
Con true incluye ítems inactivos.

Ejemplos

Un valor
Varios valores (OR)

Respuesta

Incluye data.valuesSearched: cantidad de agujas distintas usadas tras deduplicar, además de listId, matchMode, items, total, returned, truncated (mismo formato snake_case que Listar ítems).

Códigos HTTP

  • 404: lista inexistente o sin acceso para la organización.
  • 403: lista global solo marketplace no expuesta por esta API.

Ver también