> ## 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 reviews for an Account > Returns one page of reviews for a single connected Account, newest first by default. Supported on Google Business Profile and App Store Connect. App Store Connect reviews also carry a title; App Store Connect does not report an average rating, so summary.average_rating is 0 for those Accounts. ## OpenAPI ````yaml /api-reference/openapi.json get /inbox/reviews/{account_id} 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: /inbox/reviews/{account_id}: get: tags: - Inbox Reviews summary: List reviews for an Account description: >- Returns one page of reviews for a single connected Account, newest first by default. Supported on Google Business Profile and App Store Connect. App Store Connect reviews also carry a title; App Store Connect does not report an average rating, so summary.average_rating is 0 for those Accounts. parameters: - example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J description: Connected account ID name: account_id in: path required: true schema: type: string - example: 20 description: Max results (1-50, default 20) name: limit in: query schema: type: integer - description: Pagination cursor from previous response name: cursor in: query schema: type: string - description: Sort order name: order in: query schema: type: string enum: - newest - rating_asc - rating_desc responses: '200': description: Reviews with summary and pagination content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ReviewsListResponse' '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' '422': description: >- Account platform does not support reviews (account.platform_unsupported) content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' security: - BearerAuth: [] components: schemas: api_endpoints.ReviewsListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/api_endpoints.ReviewItem' pagination: $ref: '#/components/schemas/api_endpoints.InboxPagination' summary: $ref: '#/components/schemas/api_endpoints.ReviewSummaryResponse' 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.ReviewItem: type: object properties: author: $ref: '#/components/schemas/social-api_ai_core_api_connectors_base.Author' created_at: type: string example: '2026-06-20T18:24:31Z' id: type: string example: sapi_rev_TXY... media: type: array items: $ref: '#/components/schemas/api_endpoints.ReviewMediaDTO' rating: type: integer example: 3 reply: $ref: '#/components/schemas/api_endpoints.ReviewReplyDTO' reply_url: description: >- ReplyURL is the platform-hosted page for replying to this review, when the platform exposes one (Google). Empty elsewhere. type: string example: https://business.google.com/reviews/reply/abc text: type: string example: Great school title: description: >- Title is the review's headline, on platforms whose reviews have one (App Store Connect). type: string example: Love it updated_at: type: string example: '2026-06-20T18:24:31Z' api_endpoints.InboxPagination: type: object properties: has_more: type: boolean next_cursor: type: string api_endpoints.ReviewSummaryResponse: type: object properties: average_rating: type: number example: 4.2 total_count: type: integer example: 87 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 api_endpoints.ReviewMediaDTO: type: object properties: thumbnail_label: type: string example: Photo 1 thumbnail_url: type: string example: https://lh3.googleusercontent.com/p/abc video_url: type: string example: https://lh3.googleusercontent.com/v/xyz api_endpoints.ReviewReplyDTO: type: object properties: policy_violation: description: >- PolicyViolation explains a REJECTED reply, passed through verbatim from the platform. Absent otherwise. type: object state: description: >- State is the moderation outcome: PENDING, APPROVED, or REJECTED. Omitted on platforms that report no moderation state (App Store Connect). type: string example: APPROVED text: type: string example: Thanks for the feedback! updated_at: type: string example: '2026-06-21T10:00:00Z' 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.