> ## Documentation Index > Fetch the complete documentation index at: https://docs.recoupable.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get Post Stats > The platform's own analytics for one post published with [Create Post](/api-reference/publishing/create), read live through the same connection that published it. Currently LinkedIn company-page posts only; other platforms and LinkedIn personal (member) posts return 422. Each call is a fresh read and `as_of` records when it happened. Each successful read costs $0.001 (1,000 credits), charged to the caller after LinkedIn returns the numbers. Credits are checked first; a request that fails (4xx/5xx) is not charged. ## Data coverage LinkedIn reports organic activity only, within a rolling 12-month window; a post older than 12 months returns what LinkedIn still holds. ## OpenAPI ````yaml api-reference/openapi/social.json GET /api/posts/{id}/stats openapi: 3.1.0 info: title: Recoup API - Social description: >- API documentation for the Recoup platform - an AI agent platform for the music industry license: name: MIT version: 1.0.0 servers: - url: https://api.recoupable.dev security: [] paths: /api/posts/{id}/stats: get: summary: Get post stats description: >- The platform's own analytics for one post published with [Create Post](/api-reference/publishing/create), read live through the same connection that published it. Currently LinkedIn company-page posts only; other platforms and LinkedIn personal (member) posts return 422. Each call is a fresh read and `as_of` records when it happened. Each successful read costs $0.001 (1,000 credits), charged to the caller after LinkedIn returns the numbers. Credits are checked first; a request that fails (4xx/5xx) is not charged. operationId: getPostsByIdStats parameters: - name: id in: path required: true schema: type: string format: uuid description: The post's id, from [Create Post](/api-reference/publishing/create). responses: '200': description: The post's current stats. content: application/json: schema: $ref: '#/components/schemas/PostStatsResponse' '400': description: '`id` is not a valid uuid.' content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' '401': description: Unauthorized. content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' '402': description: >- Insufficient credits: the account has less than the $0.001 a read costs. Returned after the 400/401/403/404/409/422 checks and before LinkedIn is called, so nothing is read and nothing is charged. content: application/json: schema: $ref: '#/components/schemas/SocialInsufficientCreditsResponse' '403': description: Access denied to this post's account. content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' '404': description: No post with that id. content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' '409': description: >- The post cannot be read yet. Either it is not published (its status is not `posted` or it has no `post_url`; error `Post is not published yet, so it has no stats`), or the platform is not connected for the post's account (error `linkedin is not connected for this account`). This is checked before 422, so an unpublished post on any platform returns 409. content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' '422': description: >- Stats are not supported for this post. Only LinkedIn company-page posts are supported today. Errors: `Stats are not available for posts yet` (any other platform), `Stats are available for LinkedIn company-page posts only` (a LinkedIn personal post), `post_url does not name a LinkedIn post`. content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' '502': description: >- The platform rejected the stats read, for example because the connection lacks analytics access (error `LinkedIn rejected the stats read for this post`). content: application/json: schema: $ref: '#/components/schemas/PostErrorResponse' security: - apiKeyAuth: [] - bearerAuth: [] components: schemas: PostStatsResponse: type: object required: - status - stats properties: status: type: string enum: - success description: Status of the request stats: $ref: '#/components/schemas/PostStats' PostErrorResponse: type: object required: - status - error properties: status: type: string enum: - error description: Always `error` missing_fields: type: array description: >- JSON path segments to the first field that failed validation, e.g. `["description"]` items: oneOf: - type: string - type: integer error: type: string description: Human-readable error message SocialInsufficientCreditsResponse: type: object description: >- Returned (402) when the account lacks credits for the request. Nothing is charged and no Stripe object is created. Credits must be bought explicitly via [`POST /api/credits/sessions`](/api-reference/credits/sessions-create). Examples: a scrape of one profile with posts=20 requires $0.25; one post through Create Post requires $0.01. properties: error: type: string enum: - insufficient_credits remaining_credits: type: integer example: 0 required_credits: type: integer example: 250000 billingUrl: type: string description: >- Static link to the Recoup app, where a human can save a card and buy credits. It is a constant, not a freshly minted Stripe Checkout Session, so a credit-gated endpoint that keeps returning 402 creates nothing. To buy credits programmatically, call [`POST /api/credits/sessions`](/api-reference/credits/sessions-create). example: https://app.recoupable.dev required: - error - remaining_credits - required_credits - billingUrl PostStats: type: object required: - post_id - platform - post_url - impressions - unique_impressions - clicks - likes - comments - shares - engagement - video_views - viewers - watch_time_ms - as_of properties: post_id: type: string format: uuid description: The post's id. example: 3f8e2c1a-5b7d-4e9f-a1c2-6d4b8e0f2a91 platform: type: string description: The platform the post was published to. example: linkedin post_url: type: string description: The live post's URL. example: >- https://www.linkedin.com/feed/update/urn:li:share:7389012345678901248 impressions: type: - integer - 'null' description: >- Times the post was shown. `null` when the platform does not report it. example: 412 unique_impressions: type: - integer - 'null' description: >- Distinct members the post was shown to. `null` when the platform does not report it. example: 287 clicks: type: - integer - 'null' description: >- Clicks on the post's content, company name or logo. `null` when the platform does not report it. example: 19 likes: type: - integer - 'null' description: Likes (reactions). `null` when the platform does not report it. example: 14 comments: type: - integer - 'null' description: Comments. `null` when the platform does not report it. example: 3 shares: type: - integer - 'null' description: Reposts. `null` when the platform does not report it. example: 2 engagement: type: - number - 'null' description: >- LinkedIn's engagement rate for the post, from 0 to 1. `null` when the platform does not report it. example: 0.0922 video_views: type: - integer - 'null' description: >- Times the post's video was viewed; LinkedIn counts a view at 3 or more seconds. `null` for non-video posts or when LinkedIn returns none. example: 356 viewers: type: - integer - 'null' description: >- Distinct members who viewed the post's video. `null` for non-video posts or when LinkedIn returns none. example: 241 watch_time_ms: type: - integer - 'null' description: >- Total time the post's video was watched, in milliseconds. `null` for non-video posts or when LinkedIn returns none. example: 2847000 as_of: type: string format: date-time description: Server time of the read. example: '2026-10-25T18:04:12Z' securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Your Recoup API key. [Learn more](/quickstart#api-keys). bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.