> ## 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 brand mentions > Fetches posts where your brand account was mentioned or tagged. Results are sorted newest-first. Returns 501 for platforms that do not support mention tracking. On Instagram this returns only media your account was tagged in: @mentions written inside a post caption or inside a comment are never included, because Meta exposes no endpoint to poll them, and they are not currently delivered as mention.received webhooks either. On Threads, an account connected before 2026-10-17 gets an authorization error until it is reconnected. ## OpenAPI ````yaml /api-reference/openapi.json get /accounts/{id}/mentions 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: /accounts/{id}/mentions: get: tags: - Mentions summary: List brand mentions description: >- Fetches posts where your brand account was mentioned or tagged. Results are sorted newest-first. Returns 501 for platforms that do not support mention tracking. On Instagram this returns only media your account was tagged in: @mentions written inside a post caption or inside a comment are never included, because Meta exposes no endpoint to poll them, and they are not currently delivered as mention.received webhooks either. On Threads, an account connected before 2026-10-17 gets an authorization error until it is reconnected. parameters: - example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J description: Connected account ID name: id in: path required: true schema: type: string - example: '2026-02-01T00:00:00Z' description: Return only items created after this timestamp (RFC3339) name: since in: query 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: Paginated list of mentions content: application/json: schema: $ref: '#/components/schemas/api_endpoints.MentionsListResponse' '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' '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 mention tracking content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' security: - BearerAuth: [] components: schemas: api_endpoints.MentionsListResponse: type: object properties: count: type: integer data: type: array items: $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.Interaction 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.Interaction: type: object properties: account_id: description: '[always]' type: string example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J author: description: >- [always] Fields are populated only when the source platform exposes them; absent fields are omitted from JSON allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.Author content: description: >- [always] Text may be empty for attachment-only or referral interactions allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.Content conversation_id: description: >- [optional] SocialAPI conversation ID; set on Facebook, Instagram, WhatsApp and Telegram DMs that belong to a conversation type: string example: 550e8400-e29b-41d4-a716-446655440000 id: description: >- [always] SocialAPI interaction ID (sapi_cmt_/sapi_rev_/sapi_dm_/sapi_mnt_ prefix) type: string example: sapi_cmt_TT974YVQH4RAHNN2HY2DJSNY9111D7LMTP1XXPCVQVL metadata: description: >- [optional] Platform-specific keys: google sets "star_rating"; facebook mentions set "permalink_url"; instagram sets "media_id" or "referral" type: object additionalProperties: {} page_id: description: >- [platform: facebook] SocialAPI page ID identifying which Page received the event. Set for Facebook Page-scoped events; empty for platforms without a multi-page account model (e.g. Instagram), where account_id already identifies the account. type: string example: 550e8400-e29b-41d4-a716-446655440000 permalink: description: >- [optional] Public URL of the post this interaction belongs to; set for instagram comments type: string example: https://www.instagram.com/p/C8xY2AbC/ platform: description: '[always]' type: string example: instagram platform_id: description: >- [optional] Platform-native message id, byte-identical to the platform_id of the matching row from GET /v1/inbox/conversations/{id}/messages. Set on Instagram, Facebook and WhatsApp dm.received and dm.sent, on Telegram dm.received, and on Instagram and Facebook dm.postback, so a delivered event can be joined to a message from that endpoint: id is a SocialAPI interaction id, which the messages endpoint does not return, so without this the two carry no field in common. Empty for dm.referral, which has no platform message id. type: string example: m_AbCdEf123 platform_post_id: description: '[optional] Platform-native post ID; empty when not available' type: string example: '17895695668004550' post_id: description: >- [optional] SocialAPI post ID; empty when the interaction is not linked to a post type: string example: 01HZ9X3Q4R5M6N7P8V2K0W1J42 received_at: description: '[always]' type: string example: '2026-02-15T14:30:00Z' recipient: description: >- [platform: instagram, facebook, whatsapp] Non-nil for echo/sent DM events; nil for all other interaction types allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.Author reply_to: description: >- [platform: telegram, instagram, facebook] The earlier message this DM replies to; same value as reply_to on the matching row from GET /v1/inbox/conversations/{id}/messages. Absent when the DM is not a reply allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.MessageRef story: description: >- [platform: instagram] Set when the interaction is a reply to one of the account's stories allOf: - $ref: >- #/components/schemas/social-api_ai_core_api_connectors_base.Story type: description: >- [always] One of: comment, review, dm, mention (or dm.sent/dm.received/dm.referral for webhook events) type: string example: comment 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.Author: type: object properties: avatar_url: type: string example: https://example.com/avatar.jpg id: type: string example: '17841405793187218' name: type: string example: Jane Smith username: type: string example: janesmith social-api_ai_core_api_connectors_base.Content: type: object properties: media: type: array items: $ref: '#/components/schemas/social-api_ai_core_api_connectors_base.Media' text: type: string example: Love this product! Really glad I found it. social-api_ai_core_api_connectors_base.MessageRef: type: object properties: platform_id: description: >- Platform-native id of the referenced message, as platform_id on GET /v1/inbox/conversations/{id}/messages type: string example: m_AbCdEf123 social-api_ai_core_api_connectors_base.Story: type: object properties: expires_at: description: when media_url stops working; omitted when it cannot be determined type: string example: '2026-09-12T14:03:00Z' id: description: platform-native story id type: string example: '17901' media_type: description: '[platform: facebook] photo or video' type: string example: photo media_url: description: downloadable media link type: string example: https://lookaside.fbsbx.com/ig_messaging_cdn/?asset_id=17901 permalink: description: '[platform: facebook] story permalink' type: string example: https://facebook.com/stories/1784 social-api_ai_core_api_connectors_base.Media: type: object properties: type: type: string example: image url: type: string example: https://cdn.example.com/photo.jpg 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.