> ## 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. # List brand mentions > Fetches posts and stories where your brand account was mentioned or tagged. Results are sorted newest-first. Returns 501 for platforms that do not support mention tracking. ## 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 and stories where your brand account was mentioned or tagged. Results are sorted newest-first. Returns 501 for platforms that do not support mention tracking. 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' 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] Internal conversation UUID; set by facebook/instagram inbound DM handlers when linked to a stored 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_GXRM4BNTW7KFYSD3HAEV6QJZ2CLP9U 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] Internal SocialAPI page ID (account_pages.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 platform: description: '[always]' type: string example: instagram platform_post_id: description: '[optional] Platform-native post ID; empty when not available' type: string example: '17895695668004550' post_id: description: >- [optional] Internal post UUID; empty when the interaction is not linked to a stored post type: string example: 01HZ9X3Q4R5M6N7P8V2K0W1J42 received_at: description: '[always]' type: string example: '2026-02-15T14:30:00Z' recipient: description: >- [platform: instagram] 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 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.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 ````