> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Get post metrics

> Returns the saved analytics of the post: the latest daily snapshot TryPost collected from the network. No call is made to the network. LinkedIn, LinkedIn Page, Telegram, Discord and Google Business are not in analytics.



## OpenAPI

````yaml /openapi.json get /posts/{post}/metrics
openapi: 3.1.0
info:
  title: TryPost API
  version: 2.0.0
  description: >-
    REST API for TryPost. Authenticate with a workspace API key as a Bearer
    token.
servers:
  - url: https://app.trypost.it/api
    description: TryPost Cloud
security:
  - bearerAuth: []
tags:
  - name: Posts
    description: Create, read, update, delete and preview posts.
  - name: Post notes
    description: Internal notes on a post, visible to workspace members.
  - name: Approvals
    description: Approve or reject posts waiting for approval.
  - name: Recurrence
    description: Make a post repeat on a schedule.
  - name: Media and uploads
    description: Upload files and attach media to posts.
  - name: Social accounts
    description: Connected social accounts and their network-specific options.
  - name: Channels
    description: A channel's posting schedule and queue.
  - name: Ideas
    description: Ideas on the Create board.
  - name: Idea stages
    description: The groups (columns) of the ideas board.
  - name: Analytics
    description: Workspace and channel insights.
  - name: Labels
    description: Labels to organize posts and ideas.
  - name: Signatures
    description: Reusable text to append to posts.
  - name: Workspace
    description: The workspace the API key belongs to.
  - name: API keys
    description: Personal API keys for this workspace.
  - name: Webhooks
    description: Outgoing webhooks and their delivery logs.
  - name: Repurposes
    description: Automations that republish videos posted outside TryPost.
  - name: Platform
    description: Platform capabilities and content types.
paths:
  /posts/{post}/metrics:
    parameters:
      - $ref: '#/components/parameters/PostId'
    get:
      tags:
        - Posts
      summary: Get post metrics
      description: >-
        Returns the saved analytics of the post: the latest daily snapshot
        TryPost collected from the network. No call is made to the network.
        LinkedIn, LinkedIn Page, Telegram, Discord and Google Business are not
        in analytics.
      operationId: getPostMetrics
      responses:
        '200':
          description: The post's metrics.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostMetrics'
              example:
                post_id: 9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41
                platform: x
                publish_status: published
                platform_post_id: '1843921066571337728'
                platform_url: https://x.com/trypostit/status/1843921066571337728
                metrics:
                  available: true
                  reason: null
                  publication:
                    id: 9d4a0b1c-2d3e-4f5a-8b6c-7d8e9f0a1b2c
                    post_id: 9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41
                    social_account_key: 9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54
                    platform: x
                    origin: trypost
                    content_type: text
                    availability: available
                    provider_published_at: '2026-10-12T14:00:03+00:00'
                    permalink: https://x.com/trypostit/status/1843921066571337728
                    excerpt: We just shipped scheduled threads.
                    preview_metadata: null
                    poll: null
                    thread_polls: []
                    account_display_name: TryPost
                    account_username: trypostit
                    account_avatar_url: null
                  snapshot:
                    date: '2026-10-14'
                    collected_at: '2026-10-14T06:10:00+00:00'
                    provider_observed_at: '2026-10-14T06:09:58+00:00'
                    reactions_count: 42
                    comments_count: 5
                    shares_count: 7
                    saves_count: 3
                    views_count: null
                    impressions_count: 3120
                    reach_count: null
                    engagement_count: 57
                    exposure_count: 3120
                    exposure_kind: impressions
                    watch_time_milliseconds: null
                    average_watch_time_milliseconds: null
                  metrics:
                    impressions:
                      value: 3120
                      unit: count
                      time_basis: lifetime
                      precision: exact
                      availability: available
                      provider_metric: impression_count
                      period_start: null
                      period_end: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  parameters:
    PostId:
      name: post
      in: path
      required: true
      description: Post id. A post of another workspace returns `404`.
      schema:
        type: string
        format: uuid
      example: 9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41
  schemas:
    PostMetrics:
      type: object
      properties:
        post_id:
          type: string
          format: uuid
        platform:
          oneOf:
            - $ref: '#/components/schemas/Platform'
            - type: 'null'
        publish_status:
          type: string
          enum:
            - pending
            - publishing
            - retrying
            - pending_review
            - published
            - failed
            - rejected
          description: Publishing state on the network (see `Post.publish_status`).
        platform_post_id:
          type:
            - string
            - 'null'
          description: The post's id on the network.
        platform_url:
          type:
            - string
            - 'null'
        metrics:
          description: >-
            The saved analytics, or `{unsupported: true, reason}` when there are
            none: `not_published`, `platform_not_supported` (LinkedIn, LinkedIn
            Page, Telegram, Discord and Google Business are not in analytics) or
            `not_collected` (not collected yet).
          oneOf:
            - $ref: '#/components/schemas/PublicationAnalytics'
            - type: object
              title: Unavailable
              properties:
                unsupported:
                  type: boolean
                  const: true
                reason:
                  type: string
                  enum:
                    - not_published
                    - platform_not_supported
                    - not_collected
    Platform:
      type: string
      enum:
        - linkedin
        - linkedin-page
        - x
        - tiktok
        - youtube
        - facebook
        - instagram
        - instagram-facebook
        - threads
        - pinterest
        - bluesky
        - mastodon
        - telegram
        - discord
        - google_business
      description: >-
        Network of a social account. `linkedin-page` is a LinkedIn company page,
        `instagram-facebook` an Instagram account connected through a Facebook
        Page.
    PublicationAnalytics:
      type: object
      description: >-
        Saved analytics of one publication: the latest daily snapshot collected
        from the network.
      properties:
        available:
          type: boolean
          description: Always `true` on `GET /analytics/publications/{publication}`.
        reason:
          type:
            - string
            - 'null'
          description: Always `null` on `GET /analytics/publications/{publication}`.
        publication:
          type: object
          properties:
            id:
              type: string
              format: uuid
            post_id:
              type:
                - string
                - 'null'
              format: uuid
              description: TryPost post, or `null` for a post made outside TryPost.
            social_account_key:
              type:
                - string
                - 'null'
            platform:
              $ref: '#/components/schemas/Platform'
            origin:
              type: string
            content_type:
              type: string
            availability:
              type: string
              enum:
                - available
                - deleted
                - unavailable
              description: >-
                Always `available` on `GET
                /analytics/publications/{publication}`.
            provider_published_at:
              type:
                - string
                - 'null'
              format: date-time
            permalink:
              type:
                - string
                - 'null'
            excerpt:
              type:
                - string
                - 'null'
            preview_metadata:
              type:
                - object
                - 'null'
            poll:
              type:
                - object
                - 'null'
              properties:
                options:
                  type: array
                  items:
                    type: object
                    properties:
                      label:
                        type: string
                      votes:
                        type: integer
                voting_status:
                  type:
                    - string
                    - 'null'
                  enum:
                    - open
                    - closed
                    - null
                  description: >-
                    As X last reported it. `closed` only once a read after the
                    end has seen it closed.
                end_datetime:
                  type:
                    - string
                    - 'null'
                  format: date-time
                duration_minutes:
                  type:
                    - integer
                    - 'null'
              description: >-
                X polls: the votes per choice, read with the post's other X
                metrics (about an hour after publishing, then at 2, 3, 7, 14 and
                28 days). A poll made on x.com also gets them when it is
                discovered. `null` on any other post or before the first read.
            thread_polls:
              type: array
              description: >-
                X threads published by TryPost: the votes of each reply that is
                a poll. Empty otherwise.
              items:
                type: object
                properties:
                  reply:
                    type: integer
                    description: The reply's position in `meta.thread_replies`, from 0.
                  options:
                    type: array
                    items:
                      type: object
                      properties:
                        label:
                          type: string
                        votes:
                          type: integer
                  voting_status:
                    type:
                      - string
                      - 'null'
                    enum:
                      - open
                      - closed
                      - null
                    description: >-
                      As X last reported it. `closed` only once a read after the
                      end has seen it closed.
                  end_datetime:
                    type:
                      - string
                      - 'null'
                    format: date-time
                  duration_minutes:
                    type:
                      - integer
                      - 'null'
            account_display_name:
              type:
                - string
                - 'null'
            account_username:
              type:
                - string
                - 'null'
            account_avatar_url:
              type:
                - string
                - 'null'
        snapshot:
          type:
            - object
            - 'null'
          properties:
            date:
              type: string
              format: date
            collected_at:
              type:
                - string
                - 'null'
              format: date-time
            provider_observed_at:
              type:
                - string
                - 'null'
              format: date-time
            reactions_count:
              type:
                - integer
                - 'null'
            comments_count:
              type:
                - integer
                - 'null'
            shares_count:
              type:
                - integer
                - 'null'
            saves_count:
              type:
                - integer
                - 'null'
            views_count:
              type:
                - integer
                - 'null'
            impressions_count:
              type:
                - integer
                - 'null'
            reach_count:
              type:
                - integer
                - 'null'
            engagement_count:
              type:
                - integer
                - 'null'
            exposure_count:
              type:
                - integer
                - 'null'
            exposure_kind:
              type:
                - string
                - 'null'
            watch_time_milliseconds:
              type:
                - integer
                - 'null'
            average_watch_time_milliseconds:
              type:
                - integer
                - 'null'
        metrics:
          type:
            - object
            - array
          description: >-
            Metrics the network reports for this publication, keyed by metric.
            An empty array `[]` when no snapshot has been collected yet. Keys
            (`reactions`, `comments`, `views`, `impressions`, `reach`,
            `engagement_rate`, ...). Each value is an object.
          additionalProperties:
            type: object
            properties:
              value:
                type:
                  - number
                  - 'null'
              unit:
                type: string
              time_basis:
                type: string
              precision:
                type: string
              availability:
                type: string
              provider_metric:
                type:
                  - string
                  - 'null'
              period_start:
                type:
                  - string
                  - 'null'
                format: date-time
              period_end:
                type:
                  - string
                  - 'null'
                format: date-time
          maxItems: 0
    ErrorBody:
      type: object
      properties:
        message:
          type: string
    RateLimitErrorBody:
      type: object
      properties:
        name:
          type: string
          const: rate_limit_exceeded
        message:
          type: string
          examples:
            - Rate limit exceeded. Please retry after 30 seconds.
  responses:
    Unauthorized:
      description: >-
        Missing, invalid, revoked or expired API key. Bodies: `Unauthenticated.`
        (no key, or a key that is invalid or revoked), `Token expired.` (past
        its `expires_at`), `Token not found.` and `No workspace selected.` (the
        key is no longer bound to a workspace).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            message: Unauthenticated.
    PaymentRequired:
      description: >-
        TryPost Cloud only: the workspace's account has no active subscription
        or trial. Body: `{"message": "Active subscription required."}`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            message: Active subscription required.
    Forbidden:
      description: >-
        The request is not allowed. API keys work only for workspace admins (the
        account owner or a member marked as admin): otherwise every request
        returns `Insufficient workspace permissions.`. Other bodies: `Workspace
        access denied.` (the key's user left the workspace) and `Personal access
        token required.` (an MCP OAuth token was sent) and `This action is
        unauthorized.` (the note belongs to another member).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
    NotFound:
      description: The resource does not exist in this workspace.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
    TooManyRequests:
      description: 'Rate limit exceeded. Limits: 60 requests per minute per workspace.'
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitErrorBody'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Workspace API key from Settings → API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.