/signals/collectCollects one LinkedIn profile, post or company page once. Company followers have a minimum order of 100, accept max_followers, reserve exactly the requested count and always answer 202. Without max_followers, a company job asks for at most the premium credits available and adds a max_followers_missing warning. One credit per unique lead settles when results arrive. A page below the minimum answers `signals.below_minimum` (HTTP 400) with the follower count in error.details. With dry_run true, returns a free estimate without admission. Engagement collects support wait for estimates at most 500. The 202 answer carries job.id. Poll get_collect (GET /signals/collect/{id}) every 30 to 60 seconds until status is completed or failed. Then read the rows with list_signals (GET /signals): source_type collect and source_id the job id.
Premium creditsOne premium credit per lead; holds twice the expected engagers, or exactly the requested company followers (without max_followers, at most the premium credits available). Premium credits are held before work starts, and a dry run is free.Collects one LinkedIn profile, post or company page once. Company followers have a minimum order of 100, accept max_followers, reserve exactly the requested count and always answer 202. Without max_followers, a company job asks for at most the premium credits available and adds a max_followers_missing warning. One credit per unique lead settles when results arrive. A page below the minimum answers signals.below_minimum (HTTP 400) with the follower count in error.details. With dry_run true, returns a free estimate without admission. Engagement collects support wait for estimates at most 500. The 202 answer carries job.id. Poll get_collect (GET /signals/collect/{id}) every 30 to 60 seconds until status is completed or failed. Then read the rows with list_signals (GET /signals): source_type collect and source_id the job id.
kindenumrequired
What to collect. linkedin_profile: the people who react to or comment on the 10 latest posts of one profile. linkedin_post: the people who react to or comment on one post. linkedin_company: the followers of one company page.
linkedin_profilelinkedin_postlinkedin_company
targetstringrequired
The LinkedIn URL of the target. A profile URL, such as https://www.linkedin.com/in/<slug>. A post URL of the form https://www.linkedin.com/posts/<slug> or https://www.linkedin.com/feed/update/urn:li:activity:<id>. A company URL, such as https://www.linkedin.com/company/<slug>.
max_followersintegeroptional
For linkedin_company only: the most followers to collect, at least 100 and at most one million. Without it, a company job asks for at most the premium credits available, with a minimum of 100, and adds a max_followers_missing warning.
waitbooleanoptional
True keeps the request open until the rows are ready, for at most about 45 seconds, when the estimate is 500 engagers or fewer. A company page never waits. Otherwise the job runs in the background; read its rows with list_signals.
dry_runbooleanoptional
True returns only the estimate: units, premium_credits, available and sufficient. It holds no credits, starts no job and costs nothing.
The fields inside data.
jobobjectrequired
kindenumrequired
linkedin_profilelinkedin_postlinkedin_company
targetstringrequired
idstringrequired
alert_idanyrequired
statusenumrequired
queuedrunningcompletedpartialno_matchesfailedcancelled
holdintegerrequired
signalsintegerrequired
leadsintegerrequired
settled_atanyrequired
errorstring or nullrequired
scrape_outcomeanyrequired
created_atstringrequired
started_atanyrequired
completed_atanyrequired
| 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. |
| 402 | The daily or the monthly contact credit cap is spent, or the free plan's lifetime pool is. |
| 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