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

# Get Threads insights (beta)

> Beta. Returns engagement metrics for a single Threads post (level=media) or for the connected account (level=account). Requires the threads_manage_insights Threads permission, which is pending Meta App Review, so calls may return an upstream authorization error for accounts outside the app's tester roster until that permission is granted. Media metrics are views, likes, replies, reposts, quotes and shares. Account metrics are those five plus clicks, followers_count and follower_demographics. shares is media-only and clicks is account-only. follower_demographics requires exactly one breakdown (country, city, age or gender) and rejects since or until.



## OpenAPI

````yaml /api-reference/openapi.json get /platforms/threads/insights
openapi: 3.0.0
info:
  description: >-
    Unified social media inbox API. Read and respond to comments, DMs, reviews,
    and mentions across Instagram, Facebook, Threads, Google Business Profile,
    TikTok, LinkedIn, and YouTube through a single REST API. X/Twitter and
    Trustpilot coming soon.
  title: SocialAPI.AI
  contact:
    name: SocialAPI.AI Support
    email: support@social-api.ai
  license:
    name: MIT
  version: '1.0'
servers:
  - url: https://api.social-api.ai/v1
security: []
paths:
  /platforms/threads/insights:
    get:
      tags:
        - Threads
      summary: Get Threads insights (beta)
      description: >-
        Beta. Returns engagement metrics for a single Threads post (level=media)
        or for the connected account (level=account). Requires the
        threads_manage_insights Threads permission, which is pending Meta App
        Review, so calls may return an upstream authorization error for accounts
        outside the app's tester roster until that permission is granted. Media
        metrics are views, likes, replies, reposts, quotes and shares. Account
        metrics are those five plus clicks, followers_count and
        follower_demographics. shares is media-only and clicks is account-only.
        follower_demographics requires exactly one breakdown (country, city, age
        or gender) and rejects since or until.
      parameters:
        - description: Connected account ID
          name: account_id
          in: query
          required: true
          schema:
            type: string
        - description: media or account
          name: level
          in: query
          required: true
          schema:
            type: string
        - description: Platform post ID, required when level is media
          name: post_id
          in: query
          schema:
            type: string
        - description: >-
            Comma-separated metric names, defaults to all metrics valid for the
            level
          name: metric
          in: query
          schema:
            type: string
        - description: >-
            One of country, city, age, gender; only valid with
            follower_demographics
          name: breakdown
          in: query
          schema:
            type: string
        - description: Unix timestamp lower bound, must be >= 1712991600
          name: since
          in: query
          schema:
            type: integer
        - description: Unix timestamp upper bound, must be >= 1712991600
          name: until
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ThreadsInsightsResponse'
        '400':
          description: Missing or invalid parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '404':
          description: Account not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '502':
          description: Upstream Threads API error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    api_endpoints.ThreadsInsightsResponse:
      type: object
      properties:
        data:
          $ref: >-
            #/components/schemas/social-api_ai_core_api_connectors_base.ThreadsInsights
    api_endpoints.ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/api_endpoints.ErrorBody'
    social-api_ai_core_api_connectors_base.ThreadsInsights:
      type: object
      properties:
        metrics:
          type: object
          additionalProperties:
            $ref: >-
              #/components/schemas/social-api_ai_core_api_connectors_base.ThreadsMetricValue
    api_endpoints.ErrorBody:
      type: object
      properties:
        code:
          type: string
          example: resource.not_found
        message:
          type: string
          example: Account not found
        meta:
          type: object
          additionalProperties: {}
    social-api_ai_core_api_connectors_base.ThreadsMetricValue:
      type: object
      properties:
        value:
          type: integer
        values:
          type: array
          items:
            $ref: >-
              #/components/schemas/social-api_ai_core_api_connectors_base.ThreadsTimeSeriesPoint
    social-api_ai_core_api_connectors_base.ThreadsTimeSeriesPoint:
      type: object
      properties:
        end_time:
          type: string
        value:
          type: integer
  securitySchemes:
    BearerAuth:
      description: >-
        Prefix your API key with "Bearer ". Example: `Authorization: Bearer
        sapi_key_...`
      type: apiKey
      name: Authorization
      in: header

````