> ## Documentation Index > Fetch the complete documentation index at: https://socialquery.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Reddit Comment History > Read an account's public comment listing newest first. limit controls returned depth (1–100, default 25). Reserve 2 × limit credits, then charge 2 per comment actually returned; unused held credits are refunded. Successful empty results, cache hits and failed requests cost zero. before is exclusive at midnight UTC; since and until are inclusive. Dates and source order are validated; duplicate rows across source pages are removed. The source walk is bounded to 500 rows and 45 seconds. An incomplete walk returns HISTORY_WINDOW_EXCEEDED rather than a partial success. Unknown/private history and nonexistent-account behavior are not verified. Reddit score remains ext.score; likes, reply counts and author avatars are unknown. parent_id preserves t1_ reply parents and t3_ top-level parents. No public cursor is returned. Read an account's public comment listing newest first. limit controls returned depth (1–100, default 25). Reserve 2 × limit credits, then charge 2 per comment actually returned; unused held credits are refunded. Successful empty results, cache hits and failed requests cost zero. before is exclusive at midnight UTC; since and until are inclusive. Dates and source order are validated; duplicate rows across source pages are removed. The source walk is bounded to 500 rows and 45 seconds. An incomplete walk returns HISTORY\_WINDOW\_EXCEEDED rather than a partial success. Unknown/private history and nonexistent-account behavior are not verified. Reddit score remains ext.score; likes, reply counts and author avatars are unknown. parent\_id preserves t1\_ reply parents and t3\_ top-level parents. No public cursor is returned. For example, `limit=25` holds 50 credits. If 7 comments match the date window, the final charge is 14 credits and 36 are released. Send `X-Max-Credits: 50` to enforce that maximum hold on the server. The initial provider verification allowance is finite; there is no automatic refill. This endpoint is in preview while full catalog coverage is being verified. ## OpenAPI ````yaml GET /reddit/profile/comments openapi: 3.1.0 info: title: SocialQuery API version: '2026-10-09' description: >- Documented requests for public-source records. Inspect accepted inputs and credit amounts, then verify the selected operation before integrating preview coverage. servers: - url: https://socialquery.dev/v1 security: - apiKey: [] paths: /reddit/profile/comments: get: tags: - Reddit summary: Reddit account comment history description: >- Read an account's public comment listing newest first. limit controls returned depth (1–100, default 25). Reserve 2 × limit credits, then charge 2 per comment actually returned; unused held credits are refunded. Successful empty results, cache hits and failed requests cost zero. before is exclusive at midnight UTC; since and until are inclusive. Dates and source order are validated; duplicate rows across source pages are removed. The source walk is bounded to 500 rows and 45 seconds. An incomplete walk returns HISTORY_WINDOW_EXCEEDED rather than a partial success. Unknown/private history and nonexistent-account behavior are not verified. Reddit score remains ext.score; likes, reply counts and author avatars are unknown. parent_id preserves t1_ reply parents and t3_ top-level parents. No public cursor is returned. operationId: get_reddit_profile_comments parameters: - name: handle in: query required: true example: spez schema: type: string pattern: ^[A-Za-z0-9_-]{2,25}$ - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 25 description: >- Maximum comments returned, not a source page size. Holds 2 × limit credits and refunds unused credits. - name: before in: query required: false schema: type: string format: date description: >- Only comments strictly older than midnight UTC on this date. The adapter walks source pages to this window, up to 500 rows total. - name: since in: query required: false schema: type: string description: >- Inclusive YYYY-MM-DD or UTC ISO timestamp. until includes the whole UTC day for date-only input. Newest-first traversal stops after crossing since. Date aliases are not implemented. - name: until in: query required: false schema: type: string description: >- Inclusive YYYY-MM-DD or UTC ISO timestamp. until includes the whole UTC day for date-only input. Newest-first traversal stops after crossing since. Date aliases are not implemented. - name: Cache-Control in: header required: false example: no-cache schema: type: string - name: Idempotency-Key in: header required: false example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c schema: type: string - name: X-Max-Credits in: header required: false description: >- Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero. schema: type: integer minimum: 0 responses: '200': description: >- Read an account's public comment listing newest first. limit controls returned depth (1–100, default 25). Reserve 2 × limit credits, then charge 2 per comment actually returned; unused held credits are refunded. Successful empty results, cache hits and failed requests cost zero. before is exclusive at midnight UTC; since and until are inclusive. Dates and source order are validated; duplicate rows across source pages are removed. The source walk is bounded to 500 rows and 45 seconds. An incomplete walk returns HISTORY_WINDOW_EXCEEDED rather than a partial success. Unknown/private history and nonexistent-account behavior are not verified. Reddit score remains ext.score; likes, reply counts and author avatars are unknown. parent_id preserves t1_ reply parents and t3_ top-level parents. No public cursor is returned. content: application/json: schema: allOf: - $ref: '#/components/schemas/SocialQueryResponse' - type: object properties: data: type: object properties: items: type: array items: type: object properties: comment: type: object properties: id: type: string url: type: string parent_id: type: string post_id: type: string text: type: - string - 'null' author: type: object properties: username: type: - string - 'null' display_name: type: - string - 'null' avatar_url: type: 'null' verified: type: 'null' engagement: type: object properties: likes: type: 'null' replies: type: 'null' flags: type: object properties: pinned: type: - boolean - 'null' deleted: type: boolean published_at: type: string format: date-time ext: type: object properties: subreddit: type: string post_url: type: string score: type: - integer - 'null' is_submitter: type: - boolean - 'null' controversiality: type: - integer - 'null' published_at_epoch: type: number returned_count: type: integer minimum: 0 maximum: 100 source_window_count: type: integer minimum: 0 maximum: 500 pages_fetched: type: integer minimum: 1 maximum: 5 total: type: 'null' next_cursor: type: 'null' stopped_at: type: string enum: - limit - since - source_exhausted source: type: string const: scrapebadger coverage_note: type: string '400': $ref: '#/components/responses/Error400' '401': $ref: '#/components/responses/Error401' '402': $ref: '#/components/responses/Error402' '403': $ref: '#/components/responses/Error403' '404': $ref: '#/components/responses/Error404' '405': $ref: '#/components/responses/Error405' '409': $ref: '#/components/responses/Error409' '422': $ref: '#/components/responses/Error422' '429': $ref: '#/components/responses/Error429' '500': $ref: '#/components/responses/Error500' '502': $ref: '#/components/responses/Error502' '503': $ref: '#/components/responses/Error503' '504': $ref: '#/components/responses/Error504' components: schemas: SocialQueryResponse: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - data properties: success: type: boolean const: true platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean data: type: object additionalProperties: true description: >- The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null. SocialQueryError: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - error properties: success: type: boolean const: false platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean error: type: object required: - code - type - message - status - doc_url properties: code: type: string type: type: string message: type: string status: type: integer doc_url: type: string format: uri responses: Error400: description: Upstream rejected the request. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error401: description: Missing, expired, invalid, or revoked API key. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error402: description: Insufficient SocialQuery credits. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error403: description: Key scope or provider policy denied access. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error404: description: Endpoint or upstream resource not found. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error405: description: HTTP method is not supported. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error409: description: Idempotency conflict or request in progress. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error422: description: Invalid parameters. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error429: description: Request limit reached. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error500: description: Request processing failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error502: description: Upstream service failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error503: description: Provider or required service is unavailable. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error504: description: Upstream service timed out. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.