> ## 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 comments on a post > Returns comments for a specific inbox post, including per-platform capability flags (can_reply, can_delete, can_hide, can_like, can_private_reply). Uses cursor-based pagination. ## OpenAPI ````yaml /api-reference/openapi.json get /inbox/comments/{postId} 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/comments/{postId}: get: tags: - Inbox Comments summary: List comments on a post description: >- Returns comments for a specific inbox post, including per-platform capability flags (can_reply, can_delete, can_hide, can_like, can_private_reply). Uses cursor-based pagination. parameters: - example: '17895695668004550' description: Platform post ID name: postId in: path required: true schema: type: string - example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J description: Connected account ID that owns the post name: account_id in: query required: true schema: type: string - example: 25 description: >- Results per page (default 25). Some platforms return fewer, and on TikTok the first page can return more name: limit in: query schema: type: integer - description: Pagination cursor from previous response name: cursor in: query schema: type: string - example: held_for_review description: >- Filter by moderation status: published (default), held_for_review, likely_spam. YouTube only; other platforms do not filter by it. name: moderation_status in: query schema: type: string - example: relevance description: >- Order: recent (default) or relevance. YouTube only; other platforms do not sort by it. name: order in: query schema: type: string - example: great video description: >- Keyword search across comment text (max 256 chars). YouTube only; other platforms do not filter by it. name: q in: query schema: type: string responses: '200': description: Paginated list of comments with capabilities content: application/json: schema: $ref: >- #/components/schemas/api_endpoints.CommentsWithCapsListResponse '400': description: Missing required 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: Post not found in inbox content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' security: - BearerAuth: [] components: schemas: api_endpoints.CommentsWithCapsListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/api_endpoints.CommentWithCapabilities' pagination: $ref: '#/components/schemas/api_endpoints.InboxPagination' 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.CommentWithCapabilities: type: object properties: author_headline: type: string author_id: type: string author_name: type: string author_picture: type: string author_profile_url: type: string author_username: type: string capabilities: $ref: '#/components/schemas/api_endpoints.CommentCapabilities' created_at: type: string has_replies: type: boolean id: description: >- ID is the canonical SocialAPI interaction id (sapi_cmt_…). Prefer it over platform_id, which is retained for backward compatibility. type: string example: sapi_cmt_TT974YVQH4RAHNN2HY2DJSNY9111D7LMTP1XXPCVQVL is_hidden: type: boolean is_owner: type: boolean like_count: type: integer liked_by_viewer: description: >- LikedByViewer is true when the connected account has liked this comment. LinkedIn reports it directly. Instagram and Facebook do not report it on the comment read, so there it means "liked through SocialAPI": a like made in the platform's own app is not reflected. type: boolean moderation_status: description: >- ModerationStatus is the platform's moderation state for this comment, when exposed: "published", "held_for_review", "likely_spam", or "rejected". Empty when unknown or not applicable. [platform: youtube] type: string parent_id: type: string platform: type: string platform_id: type: string reply_count: description: |- ReplyCount is kept for backward compatibility but deprecated: prefer HasReplies. Not all platforms report an exact count. type: integer text: type: string api_endpoints.InboxPagination: type: object properties: has_more: type: boolean next_cursor: type: string 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.CommentCapabilities: type: object properties: can_delete: type: boolean example: true can_hide: type: boolean example: true can_like: type: boolean example: true can_private_reply: type: boolean example: true can_reply: type: boolean example: true 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.