> ## 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. # Threads Post Comments > Return a public Threads post reply-preview window from ScrapeCreators. Replies are normalized into comment wrappers; related posts and author continuations are excluded. Returns at most 25 rows, often fewer, with no cursor. The source-reported reply count describes the post, not the size or completeness of this window. Deeper reads above 25 return 422 without a credit charge. Date filters apply only to the returned source window; undated rows are retained. Exact parent-comment IDs are unknown and remain null. Return a public Threads post reply-preview window from ScrapeCreators. Replies are normalized into comment wrappers; related posts and author continuations are excluded. Returns at most 25 rows, often fewer, with no cursor. The source-reported reply count describes the post, not the size or completeness of this window. Deeper reads above 25 return 422 without a credit charge. Date filters apply only to the returned source window; undated rows are retained. Exact parent-comment IDs are unknown and remain null. One uncached successful call costs **1 credit**; failed calls and cache hits cost zero. Disabled like counts stay null. `trim=true` omits reply counts while preserving the normalized identifiers and author data. Unknown sentiment remains null. Full conversation retrieval and the deeper 50-reply mode are not yet supported. ## OpenAPI ````yaml GET /threads/post/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: /threads/post/comments: get: tags: - Threads summary: Threads Post Comments description: >- Return a public Threads post reply-preview window from ScrapeCreators. Replies are normalized into comment wrappers; related posts and author continuations are excluded. Returns at most 25 rows, often fewer, with no cursor. The source-reported reply count describes the post, not the size or completeness of this window. Deeper reads above 25 return 422 without a credit charge. Date filters apply only to the returned source window; undated rows are retained. Exact parent-comment IDs are unknown and remain null. operationId: get_threads_post_comments parameters: - name: url in: query required: true example: https://www.threads.com/@zuck/post/DZpPDXbCeTt schema: type: string - name: trim in: query required: false schema: type: boolean description: >- When true, omit reply counts from the normalized comment records. IDs, text, author, likes and timestamps remain. No media or raw provider records are returned in either mode. - name: limit in: query required: false example: 25 schema: type: integer minimum: 1 maximum: 25 description: >- Maximum preview rows to return, 1–25. Larger requests fail without charging. - name: since in: query required: false schema: type: string description: >- Filter only this preview window by YYYY-MM-DD or ISO timestamp with an explicit timezone. Date-only until includes the whole UTC day. Undated rows are kept. No archive traversal or alias parameters are supported. - name: until in: query required: false schema: type: string description: >- Filter only this preview window by YYYY-MM-DD or ISO timestamp with an explicit timezone. Date-only until includes the whole UTC day. Undated rows are kept. No archive traversal or alias parameters are supported. - 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: >- Return a public Threads post reply-preview window from ScrapeCreators. Replies are normalized into comment wrappers; related posts and author continuations are excluded. Returns at most 25 rows, often fewer, with no cursor. The source-reported reply count describes the post, not the size or completeness of this window. Deeper reads above 25 return 422 without a credit charge. Date filters apply only to the returned source window; undated rows are retained. Exact parent-comment IDs are unknown and remain null. content: application/json: schema: allOf: - $ref: '#/components/schemas/SocialQueryResponse' - type: object properties: data: type: object properties: items: type: array maxItems: 25 items: type: object properties: comment: type: object required: - id - post_id - parent_id - text - author - engagement - published_at properties: id: type: string post_id: type: string parent_id: type: 'null' url: type: - string - 'null' text: type: - string - 'null' published_at: type: - string - 'null' author: type: object properties: id: type: - string - 'null' username: type: - string - 'null' display_name: type: - string - 'null' avatar_url: type: - string - 'null' verified: type: - boolean - 'null' engagement: type: object properties: likes: type: - integer - 'null' minimum: 0 replies: type: - integer - 'null' minimum: 0 ext: type: object properties: source_shortcode: type: - string - 'null' computed: type: object properties: sentiment: type: 'null' language: type: - string - 'null' returned_count: type: integer minimum: 0 maximum: 25 total: type: 'null' next_cursor: type: 'null' post_id: type: string source_reported_replies: type: - integer - 'null' minimum: 0 source_window_count: type: integer minimum: 0 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.