Retrieve Media Replies and Conversations

Updated: Feb 2, 2026

Copy for LLM

There are two ways of retrieving a thread’s replies: GET {media-id}/replies and GET {media-id}/conversation.

GET {media-id}/replies only returns the top-level replies under the Threads ID provided in the request, while GET {media-id}/conversation returns all replies, regardless of the depth, either in chronological or reverse chronological order.

Parameters

These parameters are for both GET {media-id}/replies and GET {media-id}/conversation.

Name	Description
`reverse`	`true` if replies should be sorted in reverse chronological order. `false` if replies should be sorted in chronological order. Default: `true`

Fields

These fields are for both GET {media-id}/replies and GET {media-id}/conversation.

Name	Description
`id` (default)	The media’s ID.
`text`	Represents text for a Threads reply. This is optional on image, video, and carousel replies.
`username`	Threads username who created the post. Note: This only works for public users and your own user.
`permalink`	Permanent link to the post. Will be omitted if the media contains copyrighted material or has been flagged for a copyright violation. Note: This only works for public users and your own user.
`timestamp`	The publish date and time of the post in ISO 8601 format.
`media_product_type`	Surface where the media is published. In the case of Threads, the value is `THREADS`.
`media_type`	The media type for a Threads reply will be one of these values: `TEXT_POST`, `IMAGE`, `VIDEO`, `CAROUSEL_ALBUM`, or `AUDIO`.
`media_url`	The post’s media URL. This only shows for image, video, and carousel replies.
`shortcode`	Shortcode of the media.
`thumbnail_url`	URL of thumbnail. This only shows for Threads replies with video.
`children`	List of child posts. This only shows for carousel replies.
`is_quote_post`	Indicates if the media is a quoted reply made by another user.
`quoted_post`	Media ID of the post that was quoted. Note: This only appears on quote posts.
`has_replies`	`true` if the Threads post or reply has replies that you can see.
`root_post`	Media ID of the top-level post or original thread in the reply tree. Note: This only appears on replies.
`replied_to`	Media ID of the immediate parent of the reply. Note: This only appears on replies.
`is_reply`	`true` if the Threads media is a reply. `false` if the Threads media is a top-level post.
`is_reply_owned_by_me`	`true` if your user is the owner of the Threads reply. `false` if another user is the owner of the Threads reply. Note: This only appears on replies.
`hide_status`	Whether or not the reply is hidden. Values: `NOT_HUSHED`, `UNHUSHED`, `HIDDEN`, `COVERED`, `BLOCKED`, `RESTRICTED` Note: This only appears on replies.
`reply_audience`	Who can reply to your post. Values: `EVERYONE`, `ACCOUNTS_YOU_FOLLOW`, `MENTIONED_ONLY`, `PARENT_POST_AUTHOR_ONLY`, `FOLLOWERS_ONLY` Note: This only appears on top-level posts and replies that you own.
`gif_url`	The URL of the GIF attached to the post (if any). Note: This will only show up on posts that have a GIF attachment.
`poll_attachment`	The poll attachment for the post. Note: This will only show up on posts that have a poll.
`topic_tag`	The topic tag for the post (if any). Note: This will only show up on posts that have a topic tag.
`is_verified`	Returns `true` if the post author’s profile is verified on Threads. Note: Only available on direct replies.
`profile_picture_url`	Returns the URL of the post author’s profile picture on Threads. Note: Only available on direct replies.

A thread’s replies

Use {media-id}/replies to fetch a paginated list of all top-level replies.

This endpoint is applicable to the use cases that focus on the depth level of the replies. The endpoint returns the immediate replies of the requested Threads ID. has_replies indicates whether a Thread has nested replies or not and the field can be used to decide to chain subsequent GET calls to retrieve replies located in the deeper levels.

Example request

curl -s -X GET \
  "https://graph.threads.com/v1.0/<MEDIA_ID>/replies?fields=id,text,topic_tag,timestamp,media_product_type,media_type,media_url,shortcode,thumbnail_url,children,has_replies,root_post,replied_to,is_reply,hide_status&reverse=false&access_token=<ACCESS_TOKEN>"

Example response

{
  "data": [
    {
      "id": "1234567890",
      "text": "First Reply",
      "topic_tag": "First Topic",
      "timestamp": "2024-01-01T18:20:00+0000",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "shortcode": "abcdefg",
      "has_replies": true,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "hide_status": "NOT_HUSHED"
    },
    {
      "id": "1234567890",
      "text": "Second Reply",
      "topic_tag": "Second Topic",
      "timestamp": "2024-01-01T18:20:00+0000",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "shortcode": "abcdefg",
      "has_replies": false,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "hide_status": "HIDDEN"
    },
    {
      "id": "1234567890",
      "text": "Third Reply",
      "topic_tag": "Third Topic",
      "timestamp": "2024-01-01T18:20:00+0000",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "shortcode": "abcdefg",
      "has_replies": false,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "hide_status": "UNHUSHED"
    }
  ],
  "paging": {
    "cursors": {
      "before": "BEFORE_CURSOR",
      "after": "AFTER_CURSOR"
    }
  }
}

A thread’s conversations

Use {media-id}/conversation to fetch a paginated and flattened list of all top-level and nested replies.

This endpoint is applicable to specific use cases that do not focus on the knowledge of the depth of the replies. Note: This endpoint is only intended to be used on the root-level threads with replies.

Example request

curl -s -X GET \
  "https://graph.threads.com/v1.0/<MEDIA_ID>/conversation?fields=id,text,timestamp,media_product_type,media_type,media_url,shortcode,thumbnail_url,children,has_replies,root_post,replied_to,is_reply,hide_status&reverse=false&access_token=<ACCESS_TOKEN>"

Example response

{
  "data": [
    {
      "id": "1234567890",
      "text": "First Reply",
      "topic_tag": "First Topic",
      "timestamp": "2024-01-01T18:20:00+0000",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "shortcode": "abcdefg",
      "has_replies": true,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "hide_status": "NOT_HUSHED"
    },
    {
      "id": "1234567890",
      "text": "Second Reply",
      "topic_tag": "Second Topic",
      "timestamp": "2024-01-01T18:20:00+0000",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "shortcode": "abcdefg",
      "has_replies": false,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "hide_status": "HIDDEN"
    },
    {
      "id": "1234567890",
      "text": "Third Reply",
      "topic_tag": "Third Topic",
      "timestamp": "2024-01-01T18:20:00+0000",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "shortcode": "abcdefg",
      "has_replies": false,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "hide_status": "UNHUSHED"
    },
    {
      "id": "1234567890",
      "text": "Nested Reply",
      "topic_tag": "Nested Topic",
      "timestamp": "2024-01-01T18:20:00+0000",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "shortcode": "abcdefg",
      "has_replies": false,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "hide_status": "NOT_HUSHED"
    }
  ],
  "paging": {
    "cursors": {
      "before": "BEFORE_CURSOR",
      "after": "AFTER_CURSOR"
    }
  }
}