Skip to main content
POST
Request on-demand audience discovery for one exact LinkedIn post.

Authorizations

Authorization
string
header
required

API key created from Integrations > API & MCP > API keys. Used for Customer REST and Ordinal Audience Analytics, not MCP OAuth.

Body

application/json
postUrn
string
required

LinkedIn post URN or feed/update URL containing a LinkedIn post URN.

Maximum string length: 1024
idempotencyKey
string
Maximum string length: 120

Response

Discovery is already available, waiting for quote preparation, or represented by a durable qualification request.

status
enum<string>
required
Available options:
queued,
pending,
already_available
postId
string<uuid>
required
quoteId
string<uuid> | null

Exact quote used for the request, or the quote still being prepared.

requestId
string<uuid> | null

Durable qualification request. Null only while its quote is still preparing.

audience
object

Aggregate-only audience data, present when analytics are already available.