Basisbegrippen

Paginering

Lijsten komen per pagina. Volg next_cursor tot has_more false is, dan heb je alle objecten.

Parameters

Elk endpoint dat een lijst teruggeeft, accepteert naast zijn eigen filters dezelfde twee parameters.

limitinteger
Hoeveel objecten een pagina maximaal bevat, van 1 tot 100. Standaard 25.
cursorstring
De next_cursor van de vorige pagina. Laat hem weg voor de eerste pagina.

Het lijstobject

objectstring
Altijd list.
dataarray
De objecten van de pagina.
has_moreboolean
True als er na deze pagina nog een pagina komt.
next_cursorstring of null
De cursor van de volgende pagina, null op de laatste.

Response200

{
  "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"
}

Een pagina kan minder objecten bevatten dan limit, of zelfs geen enkel, terwijl has_more nog true is. Elk request leest een begrensd deel van de index, zodat filters snel blijven bij miljoenen leads. Baseer je loop dus altijd op has_more en next_cursor, nooit op het aantal objecten.

Gebruik op elke pagina dezelfde filters en dezelfde order. Een cursor werkt alleen met de filters waarvoor hij is gemaakt, anders krijg je een 400 cursor_invalid.
Cursors zijn ondoorzichtig. Stel er nooit zelf een samen en pas er nooit een aan.
Objecten worden gesorteerd op de volgorde van de lijst, bij gelijke waarden op ID, zodat een pagina nooit een object van de vorige pagina herhaalt.
Voor tienduizenden leads is een export sneller dan pagineren.

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

Parameters

Het lijstobject

Door alle pagina's lopen