Ordinal Audience Analytics

Request on-demand audience discovery for one exact LinkedIn post.

Changed on

Resolves the supplied LinkedIn reference to one immutable post, prepares an exact qualification quote, and accepts it as a pipeline-capacity request. Replays with the same idempotency key and payload reuse the durable request. An incompatible replay returns 409.

post/audience-analytics/linkedin-posts/find-audience

Request

Request body

postUrnstring required

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

idempotencyKeystring
requalifyboolean

Re-score the already-synced engagers of a post that already has analytics with the workspace's current ICP, instead of answering already_available. May use more leads from the pipeline-capacity allowance; people already counted are not charged again. A request in flight for the post is still returned, and a post never qualified gets the ordinary discovery. Without an idempotency key, repeats under the same ICP return the same requalification.

Response

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

status'queued' | 'pending' | 'already_available' required
postIdstring uuid required
quoteIdstring uuid nullable

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

requestIdstring uuid nullable

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

audienceobject

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

Changes

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status