Skip to main content
GET
List lead signals with safe lead, post, and Watchlist context.

Authorizations

Authorization
string
header
required

API key created from Integrations > API. Used for Customer REST and Ordinal Audience Analytics.

Query Parameters

limit
integer
default:50

Number of items to return. The default is 50 and the maximum is 100.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor returned in page.nextCursor. Pass it unchanged with the same filters and sort. Incompatible cursors return validation_failed.

Maximum string length: 256
leadId
string<uuid>
monitoredProfileId
string<uuid>
monitoredProfileIds
string

Comma-separated monitored profile IDs. Accepts up to 50 IDs.

postId
string<uuid>
engagementType
enum<string>
Available options:
LIKE,
COMMENT,
REPOST
engagementTypes
string

Comma-separated engagement types. Accepts up to three values.

dateFrom
string<date-time>

Inclusive start of the date range.

dateTo
string<date-time>

Inclusive end of the date range.

minIcpMatchPercent
integer
Required range: 0 <= x <= 100
maxIcpMatchPercent
integer
Required range: 0 <= x <= 100
disposition
enum<string>
Available options:
ACTIVE,
CLIENT,
BAD_LEAD
query
string
Required string length: 1 - 160
companyNames
string

Comma-separated company names. Accepts up to 25 values.

profileType
enum<string>
Available options:
TEAMMATE,
COMPETITOR,
INFLUENCER,
INVESTOR,
CUSTOM
relationshipLabel
string
Required string length: 1 - 80
origin
enum<string>
default:all

Safe lead origin. agent includes automated Agent and preview discovery; watchlist includes watched-profile and manual workflows.

Available options:
agent,
watchlist,
all

Response

Paginated data envelope.

data
object[]
required
page
object
required