Skip to main content
GET
/
data-lists
/
{id}
/
items
Listar itens de uma lista
curl --request GET \
  --url http://api.gu1.ai/data-lists/{id}/items \
  --header 'Authorization: Bearer <token>'

​
Visão geral

Retorna itens de uma lista, com paginação e search opcional sobre valor primário / chaves indexadas. Para consulta por um valor em primary_value e search_keys (exato ou contém), use Buscar itens por valor (POST /data-lists/{id}/items/find).

​
Endpoint

GET https://api.gu1.ai/data-lists/{id}/items

​
Autenticação

Authorization: Bearer YOUR_API_KEY

​
Parâmetros de consulta

​
page
number
default:"1"
Page number (1-based).
​
limit
number
default:"50"
Page size (capped at 50000 for export-style use cases).
​
search
string
Filter text (primary value / search keys).
​
category
string
Filter by category (empty string = all).

​
Resposta

{
  "success": true,
  "items": [],
  "total": 0,
  "categories": [],
  "page": 1,
  "limit": 50,
  "totalPages": 0
}
403 if the list is a marketplace-only global list not exposed via this API.