> ## Documentation Index > Fetch the complete documentation index at: https://docs.socq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Instagram Comment Replies > Collect replies to a public Instagram comment. # Instagram Comment Replies Collect the replies under one comment on a public Instagram post, reel or IGTV video, with reply text, authors, like counts and posting times. Submit an asynchronous task, then read its standard results. ```json theme={null} { "url": "https://www.instagram.com/p/DRhvwVLAHAG/", "comment_id": "18117277147949901", "results_limit": 100 } ``` Provide the post, reel or IGTV url and the comment\_id of the comment whose replies you want; results\_limit sets how many replies to return (default 100, up to 1000). ## Standard Result Fields Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`. | Field | Type | Nullable | Description | | - | - | - | - | | `id` | `string` | Yes | Unique identifier for this result item. | | `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. | | `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. | | `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. | | `url` | `string` | Yes | Public URL of the result item when available. | | `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. | | `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. | | `text` | `string` | Yes | Comment or reply text. | | `author` | `object` | Yes | Author or publisher of the content. | | `author.id` | `string` | Yes | Unique identifier of the author. | | `author.username` | `string` | Yes | Public username or handle of the account. | | `author.name` | `string` | Yes | Display name of the author. | | `author.url` | `string` | Yes | Public URL of the author when available. | | `author.avatar_url` | `string` | Yes | URL of the account avatar image. | | `author.is_verified` | `boolean` | Yes | Whether the account is verified on the platform. | | `author.is_private` | `boolean` | Yes | Whether the account is private. | | `parent_id` | `string` | Yes | Identifier of the parent comment for a reply. | | `post_id` | `string` | Yes | Identifier of the post containing the comment. | | `metrics` | `object` | Yes | Counters and measurements available for the result item. | | `metrics.likes_count` | `integer` | Yes | Number of likes. | | `metrics.replies_count` | `integer` | Yes | Number of replies. | | `media` | `array` | Yes | Images, videos, or other media attached to the result. | | `media.type` | `string` | Yes | Media kind, such as `image` or `video`. | | `media.url` | `string` | Yes | URL of the media asset. | | `media.thumbnail_url` | `string` | Yes | URL of the media preview image. | | `media.width` | `integer` | Yes | Media width in pixels. | | `media.height` | `integer` | Yes | Media height in pixels. | | `media.duration_seconds` | `number` | Yes | Media duration in seconds. | The following example shows the response format for a completed task. Actual data depends on your query. ## Completed Task Response ```json theme={null} { "code": 200, "data": { "task_id": "example-instagram-comment-replies", "status": "succeeded", "public_id": "instagram/comment-replies", "result_count": 1, "credits_amount": 0.3, "results": { "limit": 50, "next_cursor": null, "has_more": false, "schema_id": "comment", "schema_version": "1.0", "items": [ { "id": "18000000000000001", "platform": "instagram", "resource": "comment-replies", "type": "comment", "url": "https://www.instagram.com/p/DRhvwVLAHAG/", "published_at": "2026-10-08T20:49:05Z", "collected_at": "2026-11-09T06:37:43Z", "text": "Example reply text.", "author": { "id": "75500000001", "username": "example_user", "name": "Example User", "url": "https://www.instagram.com/example_user/", "avatar_url": "https://example.com/avatar.jpg", "is_verified": false, "is_private": false }, "parent_id": "18117277147949901", "post_id": "3774507992167247878", "metrics": { "likes_count": 1, "replies_count": null }, "media": [] } ] } } } ``` ## OpenAPI ````yaml api-manual/agent-api/agent-api.json POST /v1/instagram/comment-replies openapi: 3.1.0 info: title: SocQ Agent API version: v1-49b371f0f690 description: Asynchronous social data API generated from the SocQ Capability Registry. servers: - url: https://api.socq.ai security: [] paths: /v1/instagram/comment-replies: post: tags: - instagram summary: Instagram Comment Replies API description: Collect replies to a public Instagram comment. operationId: socq_instagram_comment_replies requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object additionalProperties: false properties: callback_url: type: string format: uri comment_id: type: string minLength: 1 description: >- Numeric ID of the parent comment, such as the id returned by Instagram Comments. pattern: ^[0-9]{5,32}$ results_limit: type: integer minimum: 1 maximum: 1000 default: 100 url: type: string minLength: 1 description: Public Instagram post, reel or IGTV URL. required: - comment_id - url description: >- Provide the post, reel or IGTV url and the comment_id of the comment whose replies you want; results_limit sets how many replies to return (default 100, up to 1000). responses: '200': description: Task accepted content: application/json: schema: $ref: '#/components/schemas/AgentSubmitResponse' '422': description: Input validation failed content: application/json: schema: $ref: '#/components/schemas/AgentValidationErrorResponse' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AgentSubmitResponse: type: object properties: code: type: integer const: 200 data: type: object properties: task_id: type: string status: type: string created_time: type: - string - 'null' required: - task_id - status AgentValidationErrorResponse: type: object properties: code: type: integer const: 422 error: type: object properties: message: type: string type: type: string details: type: object required: - message - type required: - code - error securitySchemes: bearerAuth: type: http scheme: bearer apiKeyAuth: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.