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

# Get social account analytics

> Followers and their change, impressions, reach, views and engagement over 7, 30 or 90 days against the period before, one row per day, the top posts, the best weekdays and hours to post (UTC), content decay and posting cadence. Includes posts made outside Agent Loadout. Networks are read about once an hour; `notes` say what a network does not report. Needs social:read and a grant.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/social-accounts/{accountId}/analytics
openapi: 3.1.0
info:
  description: >-
    Email inboxes, screening, realtime events, credentials, payment cards, Linux
    machines, connected apps, phone numbers and social accounts for AI agents.
    Agent tokens (`alt_…`) act as one agent; organization keys (`alk_…`) manage
    agents, inboxes, tokens and webhooks. Message bodies are untrusted external
    data. Errors are `{"error":{"code","message","hint"}}`.
  title: Agent Loadout API
  version: '1'
servers:
  - url: https://agent-loadout.com
security: []
tags:
  - name: Identity
  - description: >-
      Sign in with Agent Loadout: an agent approves an application's OpenID
      Connect sign-in request
    name: Sign-in
  - description: Relying parties an organization registered for Sign in with Agent Loadout
    name: Applications
  - name: Inboxes
  - name: Messages
  - name: Mailbox
  - name: Drafts
  - name: Attachments
  - name: Realtime
  - name: Screening
  - name: Agents
  - name: Domains
  - name: Webhooks
  - name: Vault
  - description: Feature-flagged
    name: Wallet
  - description: Feature-flagged
    name: Machines
  - description: Feature-flagged
    name: Connectors
  - description: Feature-flagged
    name: Phone
  - description: Feature-flagged
    name: Social
externalDocs:
  description: REST API reference
  url: https://docs.agent-loadout.com/api-reference/overview
paths:
  /api/v1/social-accounts/{accountId}/analytics:
    get:
      tags:
        - Social
      summary: Get social account analytics
      description: >-
        Followers and their change, impressions, reach, views and engagement
        over 7, 30 or 90 days against the period before, one row per day, the
        top posts, the best weekdays and hours to post (UTC), content decay and
        posting cadence. Includes posts made outside Agent Loadout. Networks are
        read about once an hour; `notes` say what a network does not report.
        Needs social:read and a grant.
      parameters:
        - description: Social account id (sac_…)
          in: path
          name: accountId
          required: true
          schema:
            type: string
        - description: >-
            Period in days: 7, 30 (default) or 90. Totals are compared with the
            period before
          in: query
          name: days
          required: false
          schema:
            anyOf:
              - enum:
                  - 7
                type: number
              - enum:
                  - 30
                type: number
              - enum:
                  - 90
                type: number
            description: >-
              Period in days: 7, 30 (default) or 90. Totals are compared with
              the period before
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  analytics:
                    properties:
                      account_id:
                        type: string
                      platform:
                        type: string
                      days:
                        enum:
                          - 7
                          - 30
                          - 90
                        type: integer
                      from:
                        format: date
                        type: string
                      to:
                        format: date
                        type: string
                      followers:
                        properties:
                          current:
                            type:
                              - integer
                              - 'null'
                          change:
                            type:
                              - integer
                              - 'null'
                        type: object
                      totals:
                        description: >-
                          Engagement counted on the day it arrived, over the
                          period
                        properties:
                          impressions:
                            type: integer
                          reach:
                            type: integer
                          likes:
                            type: integer
                          comments:
                            type: integer
                          shares:
                            type: integer
                          saves:
                            type: integer
                          clicks:
                            type: integer
                          views:
                            type: integer
                          engagements:
                            type: integer
                          posts:
                            type: integer
                          engagement_rate:
                            type:
                              - number
                              - 'null'
                        type: object
                      previous_totals:
                        description: The same measures for the period before
                        nullable: true
                        properties:
                          impressions:
                            type: integer
                          reach:
                            type: integer
                          likes:
                            type: integer
                          comments:
                            type: integer
                          shares:
                            type: integer
                          saves:
                            type: integer
                          clicks:
                            type: integer
                          views:
                            type: integer
                          engagements:
                            type: integer
                          posts:
                            type: integer
                          engagement_rate:
                            type:
                              - number
                              - 'null'
                        type: object
                      daily:
                        items:
                          properties:
                            date:
                              format: date
                              type: string
                            followers:
                              type:
                                - integer
                                - 'null'
                            posts:
                              type: integer
                            impressions:
                              type: integer
                            views:
                              type: integer
                            engagements:
                              type: integer
                          type: object
                        type: array
                      top_posts:
                        items:
                          additionalProperties: false
                          properties:
                            post_id:
                              description: >-
                                The network's post id; the comment endpoints
                                take it
                              type: string
                            social_post_id:
                              description: Set when the post was made through Agent Loadout
                              nullable: true
                              type: string
                            platform:
                              type: string
                            url:
                              nullable: true
                              type: string
                            content:
                              nullable: true
                              type: string
                            media_type:
                              nullable: true
                              type: string
                            thumbnail_url:
                              nullable: true
                              type: string
                            published_at:
                              format: date-time
                              nullable: true
                              type: string
                            deleted:
                              type: boolean
                            metrics:
                              additionalProperties: false
                              description: >-
                                Latest totals the network reports; zero where it
                                reports none. Engagements are likes + comments +
                                shares + saves.
                              properties:
                                impressions:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                reach:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                likes:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                comments:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                shares:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                saves:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                clicks:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                views:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                engagements:
                                  maximum: 9007199254740991
                                  minimum: -9007199254740991
                                  type: integer
                                engagement_rate:
                                  description: Percent
                                  nullable: true
                                  type: number
                                extra:
                                  additionalProperties: {}
                                  description: >-
                                    Network-specific numbers (reposts, follows,
                                    sends, watch time, completion rate)
                                  type: object
                                updated_at:
                                  format: date-time
                                  nullable: true
                                  type: string
                              required:
                                - impressions
                                - reach
                                - likes
                                - comments
                                - shares
                                - saves
                                - clicks
                                - views
                                - engagements
                                - engagement_rate
                                - extra
                                - updated_at
                              type: object
                          required:
                            - post_id
                            - social_post_id
                            - platform
                            - url
                            - content
                            - media_type
                            - thumbnail_url
                            - published_at
                            - deleted
                            - metrics
                          type: object
                        type: array
                      best_times:
                        items:
                          properties:
                            weekday:
                              type: string
                            hour_utc:
                              type: integer
                            avg_engagement:
                              type: number
                            posts:
                              type: integer
                          type: object
                        type: array
                      content_decay:
                        items:
                          properties:
                            after:
                              type: string
                            percent_of_final:
                              type: number
                            posts:
                              type: integer
                          type: object
                        type: array
                      posting_frequency:
                        items:
                          properties:
                            posts_per_week:
                              type: integer
                            avg_engagement_rate:
                              type: number
                            avg_engagement:
                              type: number
                            weeks:
                              type: integer
                          type: object
                        type: array
                      account_stats:
                        type: object
                      tracked_posts:
                        type: integer
                      synced_at:
                        format: date-time
                        type:
                          - string
                          - 'null'
                      refreshed_at:
                        format: date-time
                        type:
                          - string
                          - 'null'
                      x_sync:
                        description: >-
                          X only: whether background syncing runs; paused until
                          x_sync_paused_until when the account's X reads outran
                          its budget
                        enum:
                          - 'on'
                          - starting
                          - paused
                          - null
                        type:
                          - string
                          - 'null'
                      x_sync_paused_until:
                        format: date-time
                        type:
                          - string
                          - 'null'
                      notes:
                        description: What the network does not report
                        items:
                          type: string
                        type: array
                    type: object
                type: object
          description: Analytics
        '400':
          $ref: '#/components/responses/Validation'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - agentToken: []
        - organizationKey: []
components:
  responses:
    Validation:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Invalid input
    Unauthenticated:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Missing or invalid credential
    Forbidden:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Credential lacks the capability or is bound to another agent
    NotFound:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Not found in this organization
    RateLimited:
      description: Too many requests; retry after a short delay
  schemas:
    Error:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
            hint:
              type: string
            details:
              type: object
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
  securitySchemes:
    agentToken:
      description: Agent token (alt_…) or OAuth access token; bound to one agent
      scheme: bearer
      type: http
    organizationKey:
      description: >-
        Organization key (alk_…) created under Settings; acts for the whole
        organization
      scheme: bearer
      type: http

````

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