list signals
/signalsReturns signals newest first, with a cursor for the next page. The page size is at most 500. source_type and source_id read one source; a cursor from a filtered page keeps its filter. Reading is free: a row's contact was charged once, when the row was collected.
FreeFree.Returns signals newest first, with a cursor for the next page. The page size is at most 500. source_type and source_id read one source; a cursor from a filtered page keeps its filter. Reading is free: a row's contact was charged once, when the row was collected.
Parameters
kindstringin queryoptional
alert_idstringin queryoptional
job_idstringin queryoptional
source_typeenumin queryoptional
Reads one kind of source: alert or collect.
source_idstringin queryoptional
One alert id or collect job id. Send it only with source_type; alone it answers 400 request.invalid with field source_id.
sincestringin queryoptional
limitintegerin queryoptional
Default 50.
cursorstringin queryoptional
Response
The fields inside data.
itemsarray of objectrequired
Show child attributes
idstringrequired
kindenumrequired
linkedin_engagementcompany_follow
actionenumrequired
reactioncommentfollow
subjectstringrequired
seen_atstringrequired
sourceobjectrequired
Show child attributes
typeenumrequired
alertcollect
idstringrequired
linkedin_urlstring or nullrequired
The LinkedIn profile URL of the person who engaged or followed, as the source gave it. It is the key of the row and of the contact lookup.
namestring or nullrequired
The name the source shows for the person.
headlinestring or nullrequired
The headline the source shows for the person.
detailsanyrequired
contactanyrequired
contact_statusenumrequired
delivered: the LinkedIn URL matched a stored contact, one contact credit was charged, and contact holds it. not_found: no stored contact has this URL, or the URL is not a public profile URL; nothing was charged. credits_exhausted: a contact matched but the contact credit caps had no room; nothing was charged. account_blocked: a contact matched but the account could not be charged; nothing was charged. pending: the lookup has not run yet; nothing was charged. The lookup runs once, when the row is collected, so reading the feed again never charges again.
deliverednot_foundcredits_exhaustedaccount_blockedpending
next_cursorstring or nullrequired
Failures
| Status | Meaning |
|---|---|
| 400 | The request shape, a filter key, a value, a cursor or the enrichment mode was rejected. |
| 401 | The credential is missing, unknown or revoked. |
| 429 | The key passed 300 requests a minute or 2 concurrent requests. |
| 503 | The data is unavailable for a short time. |
Docs for agents: llms.txt