Skip to main content
POST
Discover Leads from LinkedIn Posts

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keywords
string[]
required

1 to 5 keywords or phrases to search LinkedIn posts for. Discovers leads directly from the authors of matching posts.

Required array length: 1 - 5 elements
timeframe
enum<string>
default:month

Timeframe of LinkedIn posts to search: 'day' (past 24h), 'week' (past 7 days), 'month' (past 30 days), or 'year'. Defaults to 'month'.

Available options:
day,
week,
month,
year
limit
integer
default:30

Maximum number of leads to return (up to 1000, default 30).

Required range: x <= 1000
name
string

A readable name for your enrichment job for searching on your dashboard.

includeContactDetails
boolean
default:false

Whether to find and verify email addresses and phone numbers for discovered authors. Adds +1 credit for email, +10 for phone (or +11 for both) per person.

enrichType
enum<string>[]

The type of contact details to find when includeContactDetails is true. Possible values: 'emails', 'phones'.

Available options:
emails,
phones
findInsights
boolean
default:false

Generate AI insights for each discovered lead. Charges 1.1 credits per lead if true, else 0.1 credits.

webhookUrl
string<uri>

Optional webhook URL to receive the result of the lead search operations.

streamingResults
boolean
default:false

Optional. When true and webhookUrl is provided, contact results are progressively streamed.

Response

Request accepted. Post search and enrichment is in progress.

message
string
Example:

"Lead search job successfully created and 30 leads are being processed."

enrichment_id
string<uuid>