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

# Ver métricas de uma publicação

> Retorna as análises mais recentes já salvas de uma publicação: um post publicado pelo PostClean ou encontrado num canal conectado. Pegue o id em `top_posts` de `GET /analytics` ou em `GET /channels/{account}/insights/publications`. Uma publicação apagada na rede ou indisponível, de outro workspace ou de uma rede sem análises retorna `404`.



## OpenAPI

````yaml /openapi.json get /analytics/publications/{publication}
openapi: 3.1.0
info:
  title: PostClean API
  version: 2.0.0
  description: >-
    API REST do PostClean. Autentique com uma chave de API do workspace, enviada
    como token Bearer no cabeçalho `Authorization`.
servers:
  - url: https://post.chatclean.com.br/api
    description: PostClean
security:
  - bearerAuth: []
tags:
  - name: Posts
    description: Criar, ler, atualizar, excluir e pré-visualizar posts.
  - name: Post notes
    description: Notas internas de um post, visíveis aos membros do workspace.
  - name: Approvals
    description: Aprovar ou rejeitar posts que aguardam aprovação.
  - name: Recurrence
    description: Fazer um post se repetir numa frequência.
  - name: Media and uploads
    description: Enviar arquivos e anexar mídia aos posts.
  - name: Social accounts
    description: Contas sociais conectadas e as opções de cada rede.
  - name: Channels
    description: Horários de postagem e fila de um canal.
  - name: Ideas
    description: Ideias do quadro Criar.
  - name: Idea stages
    description: As colunas (etapas) do quadro de ideias.
  - name: Analytics
    description: Métricas do workspace e dos canais.
  - name: Labels
    description: Etiquetas para organizar posts e ideias.
  - name: Signatures
    description: Textos reutilizáveis para adicionar aos posts.
  - name: Workspace
    description: O workspace ao qual a chave de API pertence.
  - name: API keys
    description: Chaves de API pessoais deste workspace.
  - name: Webhooks
    description: Webhooks de saída e os registros de entrega.
  - name: Repurposes
    description: Automações que republicam vídeos postados fora do PostClean.
  - name: Platform
    description: Recursos de cada plataforma e tipos de conteúdo.
paths:
  /analytics/publications/{publication}:
    parameters:
      - $ref: '#/components/parameters/PublicationId'
    get:
      tags:
        - Analytics
      summary: Ver métricas de uma publicação
      description: >-
        Retorna as análises mais recentes já salvas de uma publicação: um post
        publicado pelo PostClean ou encontrado num canal conectado. Pegue o id
        em `top_posts` de `GET /analytics` ou em `GET
        /channels/{account}/insights/publications`. Uma publicação apagada na
        rede ou indisponível, de outro workspace ou de uma rede sem análises
        retorna `404`.
      operationId: getPublicationAnalytics
      responses:
        '200':
          description: As análises da publicação.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicationAnalytics'
              example:
                available: true
                reason: null
                publication:
                  id: 9d4a0b1c-2d3e-4f5a-8b6c-7d8e9f0a1b2c
                  post_platform_id: 9d3c1f2b-7a5c-4d9e-8f0a-1b2c3d4e5f60
                  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/postclean/status/1843921066571337728
                  excerpt: We just shipped scheduled threads.
                  preview_metadata: null
                  account_display_name: PostClean
                  account_username: postclean
                  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
                  engagement_rate:
                    value: 1.83
                    unit: percent
                    time_basis: lifetime
                    precision: exact
                    availability: available
                    provider_metric: derived_engagements_per_impressions
                    period_start: null
                    period_end: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: >-
            A publicação não existe neste workspace, não está mais disponível na
            rede ou é de uma rede sem análises.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  parameters:
    PublicationId:
      name: publication
      in: path
      required: true
      description: >-
        Id da publicação nas métricas (o `id` de um post em destaque ou de uma
        linha de desempenho de posts do canal).
      schema:
        type: string
        format: uuid
      example: 9d4a0b1c-2d3e-4f5a-8b6c-7d8e9f0a1b2c
  schemas:
    PublicationAnalytics:
      type: object
      description: >-
        Análises salvas de uma publicação: a contagem diária mais recente
        coletada da rede.
      properties:
        available:
          type: boolean
          description: Sempre `true` em `GET /analytics/publications/{publication}`.
        reason:
          type:
            - string
            - 'null'
          description: Sempre `null` em `GET /analytics/publications/{publication}`.
        publication:
          type: object
          properties:
            id:
              type: string
              format: uuid
            post_platform_id:
              type:
                - string
                - 'null'
              format: uuid
              description: >-
                Destino do post no PostClean que gerou esta publicação, ou
                `null` num post feito fora do PostClean.
            social_account_key:
              type:
                - string
                - 'null'
              description: >-
                Chave fixa do canal nas análises. Num canal conectado, é o id da
                conta social.
            platform:
              $ref: '#/components/schemas/Platform'
            origin:
              type: string
              enum:
                - trypost
                - external
              description: >-
                `trypost` (publicado pelo PostClean) ou `external` (feito fora
                dele).
            content_type:
              type: string
              enum:
                - text
                - image
                - carousel
                - video
                - reel
                - story
                - short
                - link
                - poll
                - unknown
              description: Tipo da publicação nas análises (`text`, `image`, `video`, ...).
            availability:
              type: string
              enum:
                - available
                - deleted
                - unavailable
              description: >-
                Sempre `available` em `GET
                /analytics/publications/{publication}`.
            provider_published_at:
              type:
                - string
                - 'null'
              format: date-time
              description: Quando a rede publicou, ISO 8601 em UTC (`+00:00`).
            permalink:
              type:
                - string
                - 'null'
            excerpt:
              type:
                - string
                - 'null'
            preview_metadata:
              type:
                - object
                - 'null'
              description: >-
                Dados de prévia que a rede devolveu (por exemplo
                `thumbnail_url`).
            account_display_name:
              type:
                - string
                - 'null'
            account_username:
              type:
                - string
                - 'null'
            account_avatar_url:
              type:
                - string
                - 'null'
              description: >-
                Foto atual da conta, ou a guardada na publicação quando a conta
                não existe mais.
        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'
              description: Total de interações usado na taxa de engajamento.
            exposure_count:
              type:
                - integer
                - 'null'
              description: >-
                Base da taxa de engajamento (alcance, impressões ou
                visualizações, conforme `exposure_kind`).
            exposure_kind:
              type:
                - string
                - 'null'
              enum:
                - reach
                - impressions
                - views
                - null
              description: >-
                O que `exposure_count` mede: alcance, impressões ou
                visualizações.
            watch_time_milliseconds:
              type:
                - integer
                - 'null'
            average_watch_time_milliseconds:
              type:
                - integer
                - 'null'
          description: >-
            A contagem diária mais recente, ou `null` enquanto nenhuma foi
            coletada.
        metrics:
          type:
            - object
            - array
          description: >-
            Métricas que a rede informa para esta publicação, pela chave da
            métrica (`reactions`, `comments`, `views`, `impressions`, `reach`,
            `engagement_rate`, ...). Cada valor é um objeto. Vem como lista
            vazia `[]` enquanto nenhuma contagem foi coletada. `engagement_rate`
            é calculado pelo PostClean quando há engajamento e alcance.
          additionalProperties:
            type: object
            properties:
              value:
                type:
                  - number
                  - 'null'
              unit:
                type: string
                enum:
                  - count
                  - milliseconds
                  - percent
              time_basis:
                type: string
                enum:
                  - lifetime
                  - range
                  - rolling_90_days
                  - snapshot
              precision:
                type: string
                enum:
                  - exact
                  - approximate
                  - estimated
                  - experimental
              availability:
                type: string
                enum:
                  - available
                  - unsupported
                  - unavailable
                  - delayed
                  - privacy_limited
              provider_metric:
                type:
                  - string
                  - 'null'
                description: Nome da métrica na API da rede.
              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
      description: Corpo de erro com uma mensagem.
    Platform:
      type: string
      enum:
        - linkedin
        - linkedin-page
        - x
        - tiktok
        - youtube
        - facebook
        - instagram
        - instagram-facebook
        - threads
        - pinterest
        - bluesky
        - mastodon
        - telegram
        - discord
        - google_business
      description: >-
        Rede de uma conta social. `linkedin-page` é uma página de empresa no
        LinkedIn, e `instagram-facebook` é uma conta do Instagram conectada por
        uma Página do Facebook.
    RateLimitErrorBody:
      type: object
      properties:
        name:
          type: string
          const: rate_limit_exceeded
        message:
          type: string
          examples:
            - Rate limit exceeded. Please retry after 30 seconds.
      description: Corpo devolvido quando o limite de requisições é excedido.
  responses:
    Unauthorized:
      description: >-
        Chave de API ausente, inválida, revogada ou expirada. Corpos possíveis:
        `Unauthenticated.` (sem chave, ou chave inválida ou revogada), `Token
        expired.` (passou do `expires_at`), `Token not found.` e `No workspace
        selected.` (a chave não está mais ligada a um workspace).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            message: Unauthenticated.
    PaymentRequired:
      description: >-
        A conta do workspace não tem assinatura ativa nem período de teste.
        Corpo: `{"message": "Active subscription required."}`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            message: Active subscription required.
    Forbidden:
      description: >-
        A requisição não é permitida. Chaves de API só funcionam para
        administradores do workspace (o dono da conta ou um membro marcado como
        administrador); fora isso, toda requisição devolve `Insufficient
        workspace permissions.`. Outros corpos: `Workspace access denied.` (o
        usuário da chave saiu do workspace), `Personal access token required.`
        (foi enviado um token OAuth do MCP) e `This action is unauthorized.`
        (por exemplo, a nota pertence a outro membro).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
    TooManyRequests:
      description: 'Limite de requisições excedido: 60 por minuto por workspace.'
      headers:
        Retry-After:
          description: Segundos de espera antes de tentar de novo.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitErrorBody'
          example:
            name: rate_limit_exceeded
            message: Rate limit exceeded. Please retry after 30 seconds.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Chave de API do workspace, criada em Configurações > Chaves de API.

````

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