> ## Documentation Index > Fetch the complete documentation index at: https://docs.xpoz.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Instagram comment replies (live) > Fetch replies to a top-level comment of an Instagram post on demand. Fetches directly from the platform and returns one page with a cursor, plus the top-level comment itself in `parent_comment`. Not available for trial access keys. ## OpenAPI ````yaml https://api.xpoz.ai/openapi.json get /api/data/instagram/posts/{id}/comments/{commentId}/replies/live openapi: 3.1.0 info: title: XPOZ API version: 1.0.0 description: >- Social media data API for Twitter/X, Instagram, Reddit, and TikTok. **Data endpoints** (`/api/data/*`) are authenticated with an API access key and are metered against the account's credits. Most stored-data endpoints share the same query options: `fields` selects which attributes to return, `since`/`until` bound the date range, and `responseType` picks between a synchronous first page (`fast`), a full paged query run as a background operation (`paging`), and a CSV export (`csv`). `/live` endpoints fetch from the platform on demand and page with a cursor instead. **Account, billing, and crawl-settings endpoints** are used by the XPOZ dashboard and authenticate with the user's session. servers: - url: https://api.xpoz.ai description: Production security: [] tags: - name: Twitter (live) description: >- On-demand Twitter/X fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: Instagram (live) description: >- On-demand Instagram fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: Reddit (live) description: >- On-demand Reddit fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: TikTok (live) description: >- On-demand TikTok fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: Operations description: Polling for background operations started with `responseType=paging`. - name: Account description: Access keys, plan, and usage of the signed-in user. - name: Billing description: Stripe checkout, subscription changes, and add-on purchases. - name: Crawl Settings description: Tracked items collected on a schedule. - name: System Status description: Platform status page and notifications. - name: Platform description: Health, metrics, and this spec. paths: /api/data/instagram/posts/{id}/comments/{commentId}/replies/live: get: tags: - Instagram (live) summary: Get Instagram comment replies (live) description: >- Fetch replies to a top-level comment of an Instagram post on demand. Fetches directly from the platform and returns one page with a cursor, plus the top-level comment itself in `parent_comment`. Not available for trial access keys. operationId: getDataInstagramPostsIdCommentsCommentIdRepliesLive parameters: - $ref: '#/components/parameters/InstagramLivePostId' - $ref: '#/components/parameters/InstagramCommentId' - $ref: '#/components/parameters/InstagramCommentFields' - $ref: '#/components/parameters/Cursor' responses: '200': description: One page of results. content: application/json: schema: $ref: '#/components/schemas/InstagramCommentRepliesCursorResponse' '400': description: >- Validation failed. Also returned when the post ID is invalid: `Invalid Instagram post ID. Must be a shortcode (e.g., "DdaSlMIgeTm") or strong_id format: media_id_user_id (e.g., "3606450040306139062_4836333238").`. content: application/json: schema: $ref: '#/components/schemas/SimpleError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/TrialForbidden' default: $ref: '#/components/responses/DataRouteError' security: - AccessKey: [] components: parameters: InstagramLivePostId: name: id in: path required: true description: >- Instagram post shortcode (e.g. `DdaSlMIgeTm`, as in `instagram.com/p/DdaSlMIgeTm`) or strong ID in `media_id_user_id` format (e.g. `3606450040306139062_4836333238`). schema: type: string pattern: ^[A-Za-z0-9_-]+$ InstagramCommentId: name: commentId in: path required: true description: ID of the top-level comment. schema: type: string InstagramCommentFields: name: fields in: query required: false description: >- Instagram comment fields to return. Comma-separated. Allowed values: id, text, parentPostId, parentPostUserId, type, parentCommentId, repliedToCommentId, childCommentCount, userId, username, fullName, likeCount, status, isSpam, hasTranslation, createdAt, createdAtTimestamp, createdAtDate, images. style: form explode: false schema: type: array items: type: string enum: - id - text - parentPostId - parentPostUserId - type - parentCommentId - repliedToCommentId - childCommentCount - userId - username - fullName - likeCount - status - isSpam - hasTranslation - createdAt - createdAtTimestamp - createdAtDate - images Cursor: name: cursor in: query required: false description: Opaque cursor from `next_page_cursor` of the previous page. schema: type: string schemas: InstagramCommentRepliesCursorResponse: allOf: - $ref: '#/components/schemas/CursorResponse' - type: object properties: parent_comment: anyOf: - type: object additionalProperties: true description: >- The top-level comment the replies belong to, shaped by the requested `fields`. - type: 'null' required: - parent_comment description: >- Cursor envelope for Instagram comment replies, including the parent comment. SimpleError: type: object properties: success: type: boolean const: false message: type: string required: - success - message CursorResponse: type: object properties: results: type: array items: type: object additionalProperties: true description: Entity shaped by the requested `fields`. count: type: integer dataSource: $ref: '#/components/schemas/DataSource' has_more: type: boolean next_page_cursor: anyOf: - type: string - type: 'null' required: - results - count - dataSource - has_more - next_page_cursor description: >- Envelope for on-demand `/live` endpoints: one provider page plus a cursor. TrialForbidden: type: object properties: success: type: boolean const: false code: type: string enum: - on_demand_not_available_in_trial message: type: string required: - success - code - message DataRouteError: type: object properties: success: type: boolean const: false message: type: string description: Endpoint-specific label, e.g. `Failed to retrieve Twitter posts`. error: type: string description: Detail. `An unexpected error occurred` for unhandled failures. required: - success - message - error DataSource: type: string enum: - database - api - hybrid description: Where the results came from. responses: Unauthorized: description: Missing or invalid credentials. content: application/json: schema: $ref: '#/components/schemas/SimpleError' TrialForbidden: description: On-demand search is not available for trial access keys. content: application/json: schema: $ref: '#/components/schemas/TrialForbidden' DataRouteError: description: >- The request could not be fulfilled. Status is 400 for an empty or invalid search query, 402 when CSV export is blocked by plan limits, 500 otherwise. content: application/json: schema: $ref: '#/components/schemas/DataRouteError' securitySchemes: AccessKey: type: http scheme: bearer description: >- XPOZ API access key, created from the dashboard or `POST /api/tokens`. Send as `Authorization: Bearer `. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.