List Social Signals Leads
GET/signals/leads
Returns a paginated list of Social Signals leads belonging to the authenticated brand.
This endpoint follows the same pagination, filtering, and auth conventions as the existing campaign APIs.
Pagination​
Use page and pageSize query parameters to paginate through results.
Filtering​
| Parameter | Description | Example |
|---|---|---|
signalId | Filter by signal | ?signalId=12 |
qualified | Filter by qualification status | ?qualified=true |
exported | Filter by export status | ?exported=false |
isEmployee | Filter employee leads | ?isEmployee=false |
createdAfter | Filter to leads created after an ISO datetime | ?createdAfter=2026-04-01T00:00:00.000Z |
createdBefore | Filter to leads created before an ISO datetime | ?createdBefore=2026-04-08T23:59:59.999Z |
search | Partial match on name or headline | ?search=marketing |
Sorting​
Use the sort parameter with format field:direction. Allowed fields: createdAt, updatedAt, score1, name.
Request​
Responses​
- 200
- 401
- 403
- 429
Social Signals leads retrieved successfully
Response Headers
The maximum number of requests allowed per minute
The number of requests remaining in the current window
Unix timestamp when the rate limit window resets
Unauthorized - Invalid or missing API key
Forbidden - Active subscription required
Rate limit exceeded
Response Headers
The maximum number of requests allowed per minute
The number of requests remaining in the current window
Unix timestamp when the rate limit window resets
Seconds until the rate limit resets (only on 429 responses)