Skip to main content

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​

ParameterDescriptionExample
signalIdFilter by signal?signalId=12
qualifiedFilter by qualification status?qualified=true
exportedFilter by export status?exported=false
isEmployeeFilter employee leads?isEmployee=false
createdAfterFilter to leads created after an ISO datetime?createdAfter=2026-04-01T00:00:00.000Z
createdBeforeFilter to leads created before an ISO datetime?createdBefore=2026-04-08T23:59:59.999Z
searchPartial match on name or headline?search=marketing

Sorting​

Use the sort parameter with format field:direction. Allowed fields: createdAt, updatedAt, score1, name.

Request​

Responses​

Social Signals leads retrieved successfully

Response Headers
    X-RateLimit-Limit

    The maximum number of requests allowed per minute

    X-RateLimit-Remaining

    The number of requests remaining in the current window

    X-RateLimit-Reset

    Unix timestamp when the rate limit window resets