> ## 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. Authenticated responses can carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset for the per-minute request budget your SocialAPI account shares across every API key (see /guides/rate-limits). > 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 post metrics > Fetches engagement metrics from platform APIs for a published post. Accepts the SocialAPI post ID or a platform post ID. Instagram targets add views, reach and interactions, plus follows, profile visits and profile actions on feed posts, and watch time, skip rate and crossposted views on Reels. A metric the platform does not report for a post is omitted. If an Instagram target returns none of them, reconnect the account to grant the insights permission. ## OpenAPI ````yaml /api-reference/openapi.json get /posts/{pid}/metrics 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: /posts/{pid}/metrics: get: tags: - Posts summary: Get post metrics description: >- Fetches engagement metrics from platform APIs for a published post. Accepts the SocialAPI post ID or a platform post ID. Instagram targets add views, reach and interactions, plus follows, profile visits and profile actions on feed posts, and watch time, skip rate and crossposted views on Reels. A metric the platform does not report for a post is omitted. If an Instagram target returns none of them, reconnect the account to grant the insights permission. parameters: - description: SocialAPI post ID (UUID) or platform post ID name: pid in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/api_endpoints.MetricsResponseWrapper' '401': description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' '404': description: Post not found content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' '409': description: Platform post ID matches multiple posts content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' security: - BearerAuth: [] components: schemas: api_endpoints.MetricsResponseWrapper: type: object properties: data: $ref: '#/components/schemas/api_endpoints.MetricsResponse' api_endpoints.ErrorResponse: type: object properties: error: $ref: '#/components/schemas/api_endpoints.ErrorBody' request_id: description: >- RequestID matches the X-Request-ID response header. Include it when contacting support. type: string example: 01HZ9X3Q4R5M6N7P8V2K0W1J api_endpoints.MetricsResponse: type: object properties: post_id: type: string targets: type: array items: $ref: '#/components/schemas/api_endpoints.PostTargetResponse' api_endpoints.ErrorBody: type: object properties: code: type: string example: resource.not_found message: type: string example: Account not found meta: type: object additionalProperties: {} api_endpoints.PostTargetResponse: type: object properties: account_id: type: string example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J board_id: type: string example: '8828' error: $ref: '#/components/schemas/api_endpoints.PostTargetErrorResponse' first_comment: type: string media: type: array items: $ref: '#/components/schemas/api_endpoints.MediaInput' media_ids: description: 'Deprecated: use media.' type: array items: type: string media_type: type: string enum: - feed - reel - stories - carousel example: reel metadata: type: object additionalProperties: {} metrics: $ref: '#/components/schemas/api_endpoints.PostTargetMetricsResponse' metrics_synced_at: type: string example: '2026-04-01T12:00:00Z' page_id: type: string example: sapi_page_01HZ9X3Q4R5M6N7P8V2K0W1J permalink: type: string example: https://www.instagram.com/p/ABC123/ platform: type: string enum: - instagram - facebook - threads - tiktok - linkedin - google - zalo - youtube - twitter - bluesky - whatsapp - pinterest example: instagram platform_data: description: >- The platform-specific options set on this target, as sent in platform_data when the post was created or last updated. Chain continuation posts are returned in segments, not here. type: object additionalProperties: {} platform_media: description: >- Every image and video Instagram or Facebook reports on the published post: carousel slides or album photos in order, with a cover image for each video. The links are temporary: download the files rather than keeping the links, and call POST /v1/accounts/{id}/sync to get fresh ones. Absent on Facebook link and share posts and on other platforms. type: array items: $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.PlatformMediaItem platform_post_id: type: string example: '17895695668004550' published_at: type: string example: '2026-04-01T10:00:05Z' scheduled_at: type: string example: '2026-04-01T10:00:00Z' settings: description: >- Publish settings Instagram or Facebook reports for the published post, such as the AI info label, alt text, tagged place or audience targeting. Absent when the platform reported none. allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.PostSettings status: type: string enum: - pending - publishing - published - failed example: published text: type: string title: type: string visibility: type: string example: public api_endpoints.PostTargetErrorResponse: type: object properties: category: type: string enum: - validation - auth - rate_limit - platform - system example: validation caused_by: type: string enum: - user - platform - system example: user code: type: string example: platform.tiktok.media_required message: type: string example: Video posts require at least one media URL api_endpoints.MediaInput: type: object properties: source: type: string example: 550e8400-e29b-41d4-a716-446655440000 source_type: type: string enum: - url - media_id - platform_attachment_id example: media_id type: type: string enum: - image - video - audio - file example: image api_endpoints.PostTargetMetricsResponse: type: object properties: avg_watch_time_ms: description: Average time a viewer spent watching the video, in milliseconds. type: integer example: 7400 calls: description: Taps on the profile's call button. type: integer example: 2 comments: type: integer example: 23 crossposted_views: description: >- Views of the copy shared to another network, for a post shared there too. type: integer example: 310 directions: description: Taps on the profile's directions button. type: integer example: 1 emails: description: Taps on the profile's email button. type: integer example: 2 extra: type: object additionalProperties: {} follows: description: Accounts that followed after seeing the post. type: integer example: 12 interactions: description: >- Likes, comments, saves and shares combined, as the platform counts them. type: integer example: 204 likes: type: integer example: 142 profile_actions: description: >- Actions taken on the account's profile after visiting it from the post. website_clicks, calls, directions, emails and texts break it down. type: integer example: 15 profile_visits: description: Visits to the account's profile from the post. type: integer example: 48 reach: description: Unique accounts that saw the post. type: integer example: 3870 reposts: description: Times other accounts reposted the post. type: integer example: 6 saves: type: integer example: 31 shares: type: integer example: 8 skip_rate: description: Percentage of viewers who skipped the video near its start. type: number example: 42.5 texts: description: Taps on the profile's text message button. type: integer example: 1 total_watch_time_ms: description: Total time all viewers spent watching the video, in milliseconds. type: integer example: 37888000 views: description: Times the post was shown or played. type: integer example: 5120 website_clicks: description: Clicks on the profile's website link. type: integer example: 9 social-api_ai_core_api_connectors_base.PlatformMediaItem: type: object properties: thumbnail_url: description: >- Link to a video's cover image, hosted by the platform. Temporary, like url. Absent on images. type: string example: https://scontent.cdninstagram.com/v/t51.29350-15/456_n.jpg type: description: image or video. type: string enum: - image - video example: image url: description: >- Link to the file, hosted by the platform. Temporary: download the file rather than keeping the link. Absent when the platform withholds the file, as Instagram does for media with licensed audio. type: string example: https://scontent.cdninstagram.com/v/t51.29350-15/123_n.jpg social-api_ai_core_api_connectors_base.PostSettings: type: object properties: alt_text: description: Image description set on the Instagram post. type: string audio_type: description: Kind of audio on an Instagram Reel. type: string enum: - MUSIC - ORIGINAL_SOUND child_attachments: description: Cards of a Facebook multi-link post. type: array items: $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.PostChildAttachment comments_enabled: description: True when comments are open on the Instagram post. type: boolean countries: description: ISO 3166-1 alpha-2 countries the Facebook post is restricted to. type: array items: type: string example: - FR - BE cta_link: description: Call-to-action destination on the Facebook post. type: string cta_type: description: Call-to-action button type on the Facebook post. type: string example: SHOP_NOW is_ai_generated: description: True when Instagram shows the AI info label on the post. type: boolean max_age: description: Maximum audience age set on the Facebook post. type: integer example: 65 min_age: description: Minimum audience age set on the Facebook post. type: integer example: 18 multi_share_end_card: description: True when the multi-link post shows an end card. type: boolean multi_share_optimized: description: True when Facebook picks the card order. type: boolean place: description: Location tagged on the Facebook post. allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.PostPlace product_type: description: Instagram surface the post lives on. type: string enum: - FEED - REELS - STORY - AD share_to_feed: description: True when an Instagram Reel also appears in the main profile feed. type: boolean social-api_ai_core_api_connectors_base.PostChildAttachment: type: object properties: description: description: Description text of the card. type: string link: description: Destination URL of the card. type: string name: description: Title of the card. type: string picture: description: Image URL of the card. type: string social-api_ai_core_api_connectors_base.PostPlace: type: object properties: id: description: Platform id of the tagged place. type: string name: description: Name of the tagged place. type: string 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.