> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Get the comments of a Reddit post > Reddit Search. Read only; needs social:read. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call. Temporarily unavailable: Reddit has blocked third-party apps from its API, so this endpoint returns 503 `PLATFORM_DISABLED` until Reddit restores access. Reddit Ads is not affected. Reads the comments of any Reddit post the connected account can see, for example one found through `/apis/v1/social/reddit/feed` or `/apis/v1/social/reddit/search`, straight from Reddit on every call. ### Thread shape - The tree comes flattened in thread order (a reply follows its parent). - Rebuild it from `parentId`, which is `t3_…` for a reply to the post and `t1_…` for a reply to a comment. - Deleted and removed comments are passed through as Reddit sends them (`[deleted]` / `[removed]`). - Where Reddit truncates a thread, the ids it left out are listed in `more`. `commentId` fetches one such comment with its replies. ### Errors - 404 `platform_api_error`: Reddit no longer serves the post. - 403 `platform_api_error`: the subreddit is private. For comments on posts published through AIsa, `/apis/v1/social/inbox/comments/{postId}` adds caching, moderation and replies. A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** GET /apis/v1/social/reddit/comments/\{postId} * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/social/reddit/comments/{postId}` * **postId:** path; required * **accountId:** query; required * **sort:** query; optional * **limit:** query; optional * **commentId:** query; optional * **Runtime facts:** 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/aisa-social.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "get_aisa_social_apis_v1_social_reddit_comments_postid", "method": "GET", "path": "/apis/v1/social/reddit/comments/{postId}", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "description": "Reddit post id, with or without the `t3_` prefix (as `id` or `fullname` on RedditPost).", "in": "path", "name": "postId", "required": true, "schema": { "type": "string" } }, { "description": "One of your social accounts (acc_...).", "in": "query", "name": "accountId", "required": true, "schema": { "pattern": "^acc_[0-9A-Za-z]{22}$", "type": "string" } }, { "in": "query", "name": "sort", "required": false, "schema": { "default": "new", "enum": [ "new", "top", "best", "controversial", "old", "qa" ], "type": "string" } }, { "description": "Maximum number of top-level comments.", "in": "query", "name": "limit", "required": false, "schema": { "default": 25, "maximum": 100, "type": "integer" } }, { "description": "Return only this comment and its replies, with or without the `t1_` prefix; pass an id from `more` to expand it.", "in": "query", "name": "commentId", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "x-aisa-status": "enabled", "x-aisa-pricing": { "description": "Included with your connected social accounts: AIsa does not charge per call.", "kind": "no_customer_charge" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. ## OpenAPI ````yaml reference-contracts/aisa-social.json GET /apis/v1/social/reddit/comments/{postId} openapi: 3.1.0 info: description: '' title: AIsa Social version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: [] x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '27' response_pending: [] document_hash: sha256:7f9742cb1ea233c648dcb290fdfbf24e53a27dcf900ec1386f83a8ef2e6b1bf9 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: aisa-social x-aisa-catalogs: aisa-social: title: AIsa Social description: '' x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/social/reddit/comments/{postId}: get: summary: Get the comments of a Reddit post description: >- Reddit Search. Read only; needs social:read. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call. Temporarily unavailable: Reddit has blocked third-party apps from its API, so this endpoint returns 503 `PLATFORM_DISABLED` until Reddit restores access. Reddit Ads is not affected. Reads the comments of any Reddit post the connected account can see, for example one found through `/apis/v1/social/reddit/feed` or `/apis/v1/social/reddit/search`, straight from Reddit on every call. ### Thread shape - The tree comes flattened in thread order (a reply follows its parent). - Rebuild it from `parentId`, which is `t3_…` for a reply to the post and `t1_…` for a reply to a comment. - Deleted and removed comments are passed through as Reddit sends them (`[deleted]` / `[removed]`). - Where Reddit truncates a thread, the ids it left out are listed in `more`. `commentId` fetches one such comment with its replies. ### Errors - 404 `platform_api_error`: Reddit no longer serves the post. - 403 `platform_api_error`: the subreddit is private. For comments on posts published through AIsa, `/apis/v1/social/inbox/comments/{postId}` adds caching, moderation and replies. A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. operationId: get_aisa_social_apis_v1_social_reddit_comments_postid parameters: - description: >- Reddit post id, with or without the `t3_` prefix (as `id` or `fullname` on RedditPost). in: path name: postId required: true schema: type: string - description: One of your social accounts (acc_...). in: query name: accountId required: true schema: pattern: ^acc_[0-9A-Za-z]{22}$ type: string - in: query name: sort required: false schema: default: new enum: - new - top - best - controversial - old - qa type: string - description: Maximum number of top-level comments. in: query name: limit required: false schema: default: 25 maximum: 100 type: integer - description: >- Return only this comment and its replies, with or without the `t1_` prefix; pass an id from `more` to expand it. in: query name: commentId required: false schema: type: string responses: '200': content: application/json: schema: properties: items: items: description: >- One comment of a Reddit thread as returned by GET /apis/v1/social/reddit/comments/{postId}; the list is flat and in thread order properties: author: description: The username, or [deleted] type: string body: description: >- Comment text as written (Markdown, not HTML-escaped), or [deleted] / [removed] type: string createdUtc: description: Unix timestamp of the comment type: number depth: description: >- 0 for a top-level comment of this response, 1 for a reply to it, and so on type: integer distinguished: description: >- "moderator" or "admin" when the comment is distinguished, else null type: - string - 'null' edited: type: boolean fullname: description: Reddit fullname (e.g. t1_abc123) type: string id: description: Reddit comment ID (without type prefix) type: string isSubmitter: description: Whether the author is the post's author type: boolean numReplies: description: >- Direct replies included in this response; replies Reddit left out are listed in more type: integer parentId: description: >- Fullname of what the comment answers: the post (t3_…) or a parent comment (t1_…) type: string permalink: description: Full permalink to the comment type: string score: type: integer stickied: type: boolean type: object type: array more: description: >- Ids of comments Reddit left out of this page, at any depth. items: type: string type: array post: description: The post header; null when Reddit omits it (deleted post). oneOf: - description: >- A normalized Reddit post returned by the feed and search endpoints properties: author: type: string createdUtc: description: Unix timestamp of post creation type: number flairText: description: Link flair text if set type: - string - 'null' fullname: description: Reddit fullname (e.g. t3_abc123) type: string galleryImages: description: >- Individual image URLs for gallery posts (only present when isGallery is true) items: format: uri type: string type: array id: description: Reddit post ID (without type prefix) type: string isGallery: description: Whether the post is a gallery with multiple images type: boolean numComments: type: integer over18: description: Whether the post is marked NSFW type: boolean permalink: description: Full permalink to the Reddit post type: string score: type: integer selftext: description: Self-post body text (empty string for link posts) type: string stickied: type: boolean subreddit: type: string title: type: string url: description: >- Post URL (may be a gallery URL, external link, or self-post URL) type: string type: object - type: 'null' type: object description: The post and its comments default: content: application/json: schema: properties: error: properties: code: type: - string - 'null' details: additionalProperties: {} type: - object - 'null' message: type: - string - 'null' param: type: - string - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' type: type: - string - 'null' type: - object - 'null' type: object description: Error. The code field is stable; see the error catalog. components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.