> ## 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. > ## Agent Instructions > Base URL: https://api.social-api.ai/v1. Send your API key in the Authorization header: Authorization: Bearer . > Every error response from /v1 is JSON: { "error": { "code", "message", "meta" (optional) }, "request_id" }. Branch on error.code; use error.message only for logs. > A 429 response carries a Retry-After header, in seconds, when the limit has a known wait. > Paginated list endpoints return next_cursor, at the top level or inside pagination (see /guides/pagination). Pass it as the cursor query parameter to get the next page. An absent or empty next_cursor means you have the last page. > Treat every ID as an opaque string: do not parse it or assume a format. > Support differs by platform and by operation. Check /platforms/overview before assuming an operation works on a platform. An unsupported operation returns 501 with error.code resource.not_supported. # Get Threads insights > Returns engagement metrics for a single Threads post (level=media) or for the connected account (level=account). An account connected before 2026-10-17 gets an authorization error until it is reconnected. 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 description: >- Returns engagement metrics for a single Threads post (level=media) or for the connected account (level=account). An account connected before 2026-10-17 gets an authorization error until it is reconnected. 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: breakdown: description: Breakdown is set only for follower_demographics. type: array items: $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.ThreadsBreakdownResult 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.ThreadsBreakdownResult: type: object properties: dimension: description: >- Dimension is the breakdown value, such as a country code, a city, an age range or a gender. type: string value: type: integer 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.