Conceitos básicos

Paginação

As listas vêm uma página por vez. Siga next_cursor até has_more ser false para obter todos os objetos.

Parâmetros

Todo endpoint de lista aceita os mesmos dois parâmetros, além dos próprios filtros.

limitinteger
Quantos objetos uma página traz no máximo, de 1 a 100. O padrão é 25.
cursorstring
O next_cursor da página anterior. Omita na primeira página.

O objeto list

objectstring
Sempre list.
dataarray
Os objetos da página.
has_moreboolean
Indica se há uma página depois desta.
next_cursorstring ou null
O cursor da próxima página, null na última.

Resposta200

{
  "object": "list",
  "data": [
    {
      "id": "msgOtJ8dvT",
      "object": "lead",
      "profile": {
        "x_user_id": "1460283925",
        "username": "jane_builds",
        "name": "Jane Doe",
        "bio": "Runs a paid trading community. Daily setups, no hype.",
        "followers_count": 12400,
        "following_count": 380,
        "location": "Austin, TX",
        "website": "https://janedoe.com",
        "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
        "verified": true,
        "url": "https://x.com/jane_builds"
      },
      "score": 86,
      "score_reason": "Runs a paid trading community and asks how to collect payments for it.",
      "hot": true,
      "status": "scored",
      "persona": {
        "id": "lvWBPnytpS",
        "name": "Tipsters"
      },
      "campaign": null,
      "conversation_id": null,
      "locked_to": null,
      "found_at": "2026-11-05T14:02:11.482Z",
      "scored_at": "2026-11-05T14:03:40.117Z",
      "updated_at": "2026-11-05T14:03:40.117Z",
      "metadata": {}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzIjoiMjAyNi0xMS0wNVQxNDowMzo0MC4xMTdaIn0"
}

Uma página pode trazer menos objetos que limit, ou até nenhum, enquanto has_more ainda é true. Cada requisição lê uma fatia limitada do índice, o que mantém os filtros rápidos mesmo com milhões de leads. Baseie o loop sempre em has_more e next_cursor, nunca no número de objetos.

Mantenha os mesmos filtros e o mesmo order em todas as páginas. Um cursor só funciona com os filtros para os quais foi criado, senão a resposta é 400 cursor_invalid.
Os cursores são opacos. Nunca monte nem altere um cursor.
Os objetos seguem a ordem da lista, com empates desfeitos pelo ID, então uma página nunca repete um objeto da anterior.
Para dezenas de milhares de leads, uma exportação é mais rápida que paginar.

curl -G https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d hot=true \
  -d limit=100

# The next page, with the next_cursor of the one before
curl -G https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d hot=true \
  -d limit=100 \
  -d cursor=eyJzIjoiMjAyNi0xMS0wNVQxNDowMzo0MC4xMTdaIn0

Parâmetros

O objeto list

Percorrer todas as páginas