---
title: "Request on-demand audience discovery for one exact LinkedIn post."
method: POST
path: "/audience-analytics/linkedin-posts/find-audience"
tags: ["Ordinal Audience Analytics"]
---

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

`POST /audience-analytics/linkedin-posts/find-audience`

## Request

- Base URL: `https://api.traxy.ai/api/v1`
- URL: `https://api.traxy.ai/api/v1/audience-analytics/linkedin-posts/find-audience`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/docs/audience-analytics/linkedin-posts/find-audience/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Request body

- object
  - `postUrn` string, required: LinkedIn post URN or `feed/update` URL containing a LinkedIn post URN.
  - `idempotencyKey` string
  - `requalify` boolean: 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 `202`

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

- AudienceDiscoveryResponse
  - `status` 'queued' | 'pending' | 'already_available', required
  - `postId` string, uuid, required
  - `quoteId` string, uuid, nullable: Exact quote used for the request, or the quote still being prepared.
  - `requestId` string, uuid, nullable: Durable qualification request. Null only while its quote is still preparing.
  - `audience` object: Aggregate-only audience data, present when analytics are already available.

## Other responses

- `400`: Request failed boundary validation.
- `401`: Invalid, expired, or revoked API key.
- `402`: The full exact quote could not be reserved. No qualification request was created.
- `404`: Resource not found for the key workspace.
- `409`: Malformed or unsupported LinkedIn URN. Valid absent and cross-workspace post URNs use NotFound.
- `429`: Customer API rate limit exceeded or rate-limit enforcement is temporarily unavailable. Retry after the delay in Retry-After.

## Changes

- **2026-11-11** `765b1a6a3abd`: 1 info
  - added the new optional request property `requalify`
- **2026-09-24** `3dde15782092`: 5 info
  - added the optional property `audience` to the response with the `202` status
  - added the optional property `quoteId` to the response with the `202` status
  - added the optional property `requestId` to the response with the `202` status
  - added the required property `postId` to the response with the `202` status
  - …1 more
- **2026-07-04** `467b330a307b`: 2 breaking, 2 warning, 3 info
  - removed the required property `postId` from the response with the `202` status
  - removed the required property `status` from the response with the `202` status
  - removed the optional property `audience` from the response with the `202` status
  - removed the optional property `runId` from the response with the `202` status
  - …3 more
- **2026-06-16** `033f909970d5`: 1 info
  - endpoint added
- **2026-06-12** `f103a3a38e28`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/changes/audience-analytics/linkedin-posts/find-audience/post.md)

---

[API](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1.md) - [All operations](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/revisions/765b1a6a3abd?raw)