> ## 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. # List active Instagram stories > Returns the currently-active stories for a connected Instagram account. Stories are ephemeral and expire about 24 hours after posting; each item carries is_story and a computed expires_at in metadata. Returns 501 for non-Instagram accounts. ## OpenAPI ````yaml /api-reference/openapi.json get /platforms/instagram/accounts/{id}/stories 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/instagram/accounts/{id}/stories: get: tags: - Instagram summary: List active Instagram stories description: >- Returns the currently-active stories for a connected Instagram account. Stories are ephemeral and expire about 24 hours after posting; each item carries is_story and a computed expires_at in metadata. Returns 501 for non-Instagram accounts. parameters: - example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J description: Connected account ID name: id in: path required: true schema: type: string - example: 20 description: Maximum number of results to return (1-100, default 20) name: limit in: query schema: type: integer - description: Pagination cursor returned by the previous response name: cursor in: query schema: type: string responses: '200': description: List of active stories content: application/json: schema: $ref: '#/components/schemas/api_endpoints.InstagramStoriesResponse' '400': description: Invalid query parameters 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' '403': description: Platform access not permitted for your plan 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' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' '501': description: Platform does not support stories content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' security: - BearerAuth: [] components: schemas: api_endpoints.InstagramStoriesResponse: type: object properties: count: type: integer data: type: array items: $ref: '#/components/schemas/social-api_ai_core_api_connectors_base.Post' next_cursor: type: string 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 social-api_ai_core_api_connectors_base.Post: type: object properties: account_id: description: '[always]' type: string caption: description: '[always] Post text body; may be empty for media-only posts' type: string comments_count: description: '[platform: instagram, facebook, tiktok] Zero on other platforms' type: integer id: description: '[always] Platform-native post/video/media ID' type: string like_count: description: '[platform: instagram, facebook, tiktok] Zero on other platforms' type: integer media_type: description: >- [platform: instagram, facebook, threads, tiktok, youtube] Empty on linkedin and google type: string media_url: description: >- [platform: instagram, tiktok, youtube] Cover image or media URL; empty on facebook, threads, linkedin, google type: string metadata: description: >- [optional] Platform-specific keys; facebook sets "page_id" and "page_name" type: object additionalProperties: {} permalink: description: >- [platform: instagram, facebook, threads, tiktok, youtube, google, linkedin, linkedin_page] type: string platform: description: '[always]' type: string platform_media: description: >- [platform: instagram, facebook] Every image and video on the post, carousel slides or album photos in order type: array items: $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.PlatformMediaItem settings: description: >- [platform: instagram, facebook] Settings the platform reports for the post allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.PostSettings shares_count: description: '[platform: facebook] Zero on other platforms' type: integer timestamp: description: '[always]' type: string view_count: description: '[platform: youtube, tiktok] Zero on other platforms' type: integer 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.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.