Pular para o conteúdo principal

Como funciona

Todos os endpoints de listagem usam paginação baseada em cursor. Cada resposta inclui metadados de paginação:
{
  "data": [...],
  "pagination": {
    "cursor": "eyJpZCI6IjEyMyJ9",
    "hasMore": true,
    "total": 487
  }
}

Solicitando páginas

Passe o cursor da resposta anterior para buscar a próxima página:
# Primeira página (padrão: 50 itens)
curl ".../brands?limit=20"

# Próxima página
curl ".../brands?limit=20&cursor=eyJpZCI6IjEyMyJ9"

Parâmetros

ParâmetroTipoPadrãoDescrição
limitinteger50Itens por página (máx 100)
cursorstringCursor da resposta anterior

Iterando por todas as páginas

async function fetchAllBrands(workspaceId) {
  let cursor = null;
  const allBrands = [];

  do {
    const url = new URL(`.../brands`);
    url.searchParams.set('limit', '100');
    if (cursor) url.searchParams.set('cursor', cursor);

    const response = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
    const { data, pagination } = await response.json();

    allBrands.push(...data);
    cursor = pagination.hasMore ? pagination.cursor : null;
  } while (cursor);

  return allBrands;
}
Last modified on February 16, 2026