Concetti di base

Paginazione

Gli elenchi arrivano una pagina alla volta. Segui next_cursor finché has_more diventa false, e avrai tutti gli oggetti.

Parametri

Ogni endpoint di elenco accetta gli stessi due parametri, oltre ai propri filtri.

limitinteger
Quanti oggetti contiene al massimo una pagina, da 1 a 100. Il valore predefinito è 25.
cursorstring
Il next_cursor della pagina precedente. Omettilo per la prima pagina.

L'oggetto list

objectstring
Sempre list.
dataarray
Gli oggetti della pagina.
has_moreboolean
True quando c'è un'altra pagina dopo questa.
next_cursorstring o null
Il cursore della pagina successiva, null sull'ultima.

Risposta200

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

Una pagina può contenere meno oggetti di limit, anche nessuno, mentre has_more è ancora true. Ogni richiesta legge una porzione limitata dell'indice, così i filtri restano veloci su milioni di lead. Basa sempre il ciclo su has_more e next_cursor, mai sul numero di oggetti.

Mantieni gli stessi filtri e lo stesso order su ogni pagina. Un cursore funziona solo con i filtri per cui è stato creato, altrimenti la risposta è 400 cursor_invalid.
I cursori sono opachi. Non costruirne né modificarne mai uno.
Gli oggetti seguono l'ordine dell'elenco e, a parità, l'ID, così una pagina non ripete mai un oggetto della pagina precedente.
Per decine di migliaia di lead, un export è più veloce della paginazione.

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

Parametri

L'oggetto list

Scorri tutte le pagine