Skip to main content
GET
/
api
/
v2
/
streams
/
{streamId}
/
leads
Get leads from a stream
curl --request GET \
  --url https://api.example.com/api/v2/streams/{streamId}/leads
Returns leads from one campaign. Supports filtering by lifecycle, match confidence, account, segment, and date. For cross-campaign extraction use GET /api/v2/leads.

​
Query parameters

NameTypeDescription
lifecycleenum"new" (un-exported) or "exported"
matchConfidenceenum"high" or "medium"
accountIdnumberScope to one source account
segmentIdnumberScope to one segment
sinceISO 8601Leads discovered after this timestamp
limitnumberDefault 100, max 500
offsetnumberPagination
summarybooleanReturn only counts (replaces the legacy /lead-counts endpoint)

​
Response (default)

{
  "leads": [
    {
      "id": 1234,
      "streamId": 42,
      "trackedXAccountId": 7,
      "segmentId": 12,
      "matchConfidence": "high",
      "sourceType": "new_follower",
      "discoveredAt": "2026-06-02T09:01:00Z",
      "exportedAt": null,
      "profile": {
        "xUserId": "1234567890",
        "handle": "alice",
        "displayName": "Alice Smith",
        "profileImageUrl": "...",
        "followerCount": 8200,
        "bio": "..."
      }
    }
  ],
  "total": 47,
  "hasMore": false
}

​
Response with ?summary=true

{ "highFitCount": 33, "mediumFitCount": 14 }

​
Auth

Bearer or session cookie.