> ## Documentation Index > Fetch the complete documentation index at: https://getanyapi.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Reddit User Comments > List a Reddit user's comments by username, sorted by new, top, hot, or controversial, with the parent post title and subreddit on every item and cursor pagination. Comment text comes back as a roughly 300-character preview rather than the full body, and this endpoint carries no per-comment permalink; use reddit.post_comments for full comment bodies and comment URLs on a given post. **Price:** \$1.00 per 1,000 requests (flat per request - same cost regardless of results returned). **Routing:** one lane serves this API today, so a failed attempt has nowhere to fail over to. Failed attempts are never billed. ## OpenAPI ````yaml /openapi.json post /v1/run/reddit.user_comments openapi: 3.1.0 info: contact: email: support@getanyapi.com description: >- Any API, one wallet, USD, no subscriptions. Each API is a single discovered operation: send the normalized input, get a normalized result. You are charged the winning provider's price in real dollars only on success; failed calls are never charged. title: AnyAPI version: 1.0.0 x-guidance: >- Use each operation's published method and path with its normalized JSON input (see the operation requestBody). To pay: send your AnyAPI key (Authorization: Bearer, billed from your USD wallet); or pay per call inline with no account - x402 (call with no key, get HTTP 402 with a PAYMENT-REQUIRED header, retry with the PAYMENT-SIGNATURE header, USDC on base), or MPP (retry with Authorization: Payment, tempo). You are charged only on success. servers: - url: https://api.getanyapi.com security: - bearerAuth: [] - apiKeyAuth: [] tags: - name: ahrefs x-group: Ahrefs - name: airbnb x-group: Airbnb - name: alibaba x-group: Alibaba - name: amazon x-group: Amazon - name: apollo x-group: Apollo - name: appstore x-group: Appstore - name: bluesky x-group: Bluesky - name: booking x-group: Booking - name: coinmarketcap x-group: Coinmarketcap - name: congress x-group: Congress - name: dexscreener x-group: Dexscreener - name: douyin x-group: Douyin - name: ebay x-group: Ebay - name: email x-group: Email - name: facebook x-group: Facebook - name: fiverr x-group: Fiverr - name: github x-group: Github - name: glassdoor x-group: Glassdoor - name: google x-group: Google - name: google-ads x-group: Google Ads - name: google-finance x-group: Google Finance - name: google-shopping x-group: Google Shopping - name: hackernews x-group: Hackernews - name: indeed x-group: Indeed - name: instagram x-group: Instagram - name: linkedin x-group: Linkedin - name: maps x-group: Maps - name: pandaexpress x-group: Pandaexpress - name: person x-group: Person - name: pinterest x-group: Pinterest - name: playstore x-group: Playstore - name: polymarket x-group: Polymarket - name: realtor x-group: Realtor - name: reddit x-group: Reddit - name: redfin x-group: Redfin - name: rednote x-group: Rednote - name: sec x-group: Sec - name: semrush x-group: Semrush - name: seo x-group: Seo - name: snapchat x-group: Snapchat - name: social x-group: Social - name: spotify x-group: Spotify - name: substack x-group: Substack - name: threads x-group: Threads - name: tiktok x-group: TikTok - name: tiktok-shop x-group: TikTok Shop - name: tripadvisor x-group: Tripadvisor - name: trustpilot x-group: Trustpilot - name: truthsocial x-group: Truthsocial - name: twitter x-group: X (Twitter) - name: upwork x-group: Upwork - name: walmart x-group: Walmart - name: web x-group: Web - name: weibo x-group: Weibo - name: yahoo-finance x-group: Yahoo Finance - name: yelp x-group: Yelp - name: youtube x-group: YouTube - name: zhihu x-group: Zhihu - name: zillow x-group: Zillow paths: /v1/run/reddit.user_comments: post: tags: - reddit summary: Reddit User Comments description: >- List a Reddit user's comments by username, sorted by new, top, hot, or controversial, with the parent post title and subreddit on every item and cursor pagination. Comment text comes back as a roughly 300-character preview rather than the full body, and this endpoint carries no per-comment permalink; use reddit.post_comments for full comment bodies and comment URLs on a given post. **Price:** \$1.00 per 1,000 requests (flat per request - same cost regardless of results returned). **Routing:** one lane serves this API today, so a failed attempt has nowhere to fail over to. Failed attempts are never billed. operationId: reddit_user_comments parameters: - description: >- Optional. Comma-separated keys (dotted paths like `author.name` descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the `data`/`items` envelope is unwrapped, not against the top-level response envelope, so use `jq` to reshape the whole envelope. Shrinks the response without changing cost. in: query name: fields required: false schema: type: string - description: >- Optional. Cap the number of result rows returned; a `_truncated` note reports how many were withheld so you can page via the API's own `limit`. Does not change cost. in: query name: max_items required: false schema: minimum: 0 type: integer - description: >- Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost. in: query name: summary required: false schema: type: boolean - description: >- Optional. A jq expression applied to the result envelope; its output replaces `output` (multiple outputs collect into an array). Reshape freely, e.g. `jq=.data | {title, description, md: .markdown[:3500]}`. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a `jqError`. Does not change cost. in: query name: jq required: false schema: type: string - description: >- Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict. in: header name: Idempotency-Key required: false schema: maxLength: 255 minLength: 1 type: string requestBody: content: application/json: example: username: spez schema: additionalProperties: false example: username: spez properties: cursor: description: >- Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it back to fetch the next page. minLength: 1 type: string limit: default: 25 description: >- Maximum number of comments to return in this response (a page cap, not a total). Defaults to 25. maximum: 100 minimum: 1 type: integer sort: description: >- Sort order for the user's comments. Defaults to new (most recent first). enum: - new - top - hot - controversial type: string username: description: 'Reddit username, without the u/ prefix. Example: "spez".' minLength: 1 type: string required: - username title: Reddit user comments input type: object x-aliases: handle: username required: true responses: '200': content: application/json: schema: properties: costUsd: description: >- USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free. type: number items: description: >- Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count. type: integer jqError: description: >- Present only when a `jq` expression failed; `output` then carries the full unshaped result and this explains why the reshape did not apply. type: string output: anyOf: - additionalProperties: false properties: data: description: >- One page of the user's comments, or null when the user was not found. oneOf: - type: 'null' - additionalProperties: false properties: comments: description: >- The user's comments in feed order (newest first by default). Each item carries a truncated body preview plus the parent post it was made on; there is no per-comment permalink available from this endpoint. Populated whenever the provider has data for the entity. items: properties: author: description: >- Commenter username, without the u/ prefix. Populated whenever the provider has data for the entity. type: string x-anyapi-must-populate: true bodyPreview: description: >- A preview of the comment text, not the full comment body: the upstream truncates it to roughly 300 characters and cuts mid-word. It is plain text rather than Markdown, and it is empty on the occasional comment for which the upstream returns no preview at all. For full comment bodies and comment permalinks, use the reddit.post_comments SKU against the parent post. type: string createdUtc: description: >- UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. type: number id: description: >- Reddit comment ID (base-36, without the t1_ prefix). Populated whenever the provider has data for the entity. type: string x-anyapi-must-populate: true postId: description: >- Reddit post ID of the thread the comment was made on (base-36, without the t3_ prefix). Pass it to reddit.post or reddit.post_comments for the full thread. Populated whenever the provider has data for the entity. type: string x-anyapi-must-populate: true postTitle: description: >- Title of the thread the comment was made on. Populated whenever the provider has data for the entity. type: string x-anyapi-must-populate: true score: description: >- Net score (upvotes minus downvotes) on the comment at fetch time. type: integer subreddit: description: >- Subreddit name of the parent thread, without the r/ prefix. Empty when the comment is on a post hosted on a user's own profile (r/u_), which has no subreddit. type: string required: - id - author - createdUtc type: object type: array x-anyapi-must-populate: true nextCursor: description: >- Opaque cursor for the next page of this user's comments; pass it back as the `cursor` input to fetch the following page. Null when there are no more pages. type: - string - 'null' required: - comments - nextCursor type: object found: description: Whether the user's comment history was returned. type: boolean required: - found - data title: Reddit user comments output type: object - type: 'null' description: >- Normalized output, or null when the replay payload was not retained. provider: description: Always "AnyAPI". type: string replayed: description: >- True when this response replays the durable result of an earlier run without billing or upstream execution. type: boolean resultId: description: >- Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache. type: string required: - output - provider - costUsd - replayed type: object description: Normalized result. headers: Idempotency-Replayed: description: >- Present only when the request carried an Idempotency-Key this gateway honored. "false" means the key was claimed and the run executed freshly; "true" means it replayed a prior identical run and was NOT charged again. Absent means either no key was sent or this gateway does not honor keys, so a retry could be charged twice. schema: enum: - 'false' - 'true' type: string '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Input did not match the schema, or the upstream rejected the request (no charge). '401': content: application/json: schema: $ref: '#/components/schemas/Error' description: Missing or invalid API key. '402': content: application/json: schema: oneOf: - $ref: '#/components/schemas/PaymentRequiredError' - $ref: '#/components/schemas/TrialCapReached' description: >- Insufficient wallet balance or spend cap (no charge). Agent trials receive a trial_cap_reached continuation with a live RFC 8628 device authorization. '404': content: application/json: schema: $ref: '#/components/schemas/Error' description: Unknown SKU, or the upstream had no matching resource (no charge). '409': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Idempotency collision. Codes: idempotency_in_progress means retry after the Retry-After delay; idempotency_conflict means use a new key for different request semantics; idempotency_needs_review means stop retrying and contact AnyAPI support with X-Anyapi-Request-Id. '422': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- The request was well formed but this API cannot serve the requested target site; the body's `alternatives` array lists the AnyAPI APIs that can (no charge). '429': content: application/json: schema: $ref: '#/components/schemas/Error' description: The upstream was rate limited, retry shortly (no charge). '502': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Every provider failed with a server/transport error (charge released). components: schemas: Error: properties: code: description: Stable machine-readable error code when the endpoint defines one. type: string error: description: Customer-safe error message. type: string required: - error type: object PaymentRequiredError: allOf: - $ref: '#/components/schemas/Error' - properties: error: not: const: trial_cap_reached type: object TrialCapReached: properties: error: const: trial_cap_reached type: string message: description: >- Human-relayable continuation instructions, including an executable token poll. type: string upgrade: $ref: '#/components/schemas/AgentUpgrade' required: - error - message - upgrade type: object AgentUpgrade: properties: authorizationServer: format: uri type: string clientId: type: string device: $ref: '#/components/schemas/DeviceUpgrade' scope: type: string required: - authorizationServer - scope type: object DeviceUpgrade: properties: deviceCode: type: string expiresIn: minimum: 0 type: integer grantType: type: string interval: minimum: 1 type: integer tokenEndpoint: format: uri type: string userCode: type: string verificationUri: format: uri type: string verificationUriComplete: format: uri type: string required: - verificationUriComplete - verificationUri - userCode - deviceCode - tokenEndpoint - grantType - interval - expiresIn type: object securitySchemes: bearerAuth: description: Your AnyAPI key as a Bearer token. scheme: bearer type: http x-default: YOUR_ANYAPI_KEY apiKeyAuth: description: Your AnyAPI key. in: header name: X-API-Key type: apiKey x-default: YOUR_ANYAPI_KEY ````