Retrieve User Replies

You can retrieve a list of a user's replies.

Retrieve a List of a User's Replies

Use the GET /{threads-user-id}/replies endpoint to return a paginated list of all replies created by a user.

Fields

Here's a list of fields that can be returned for each reply.

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.
`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.
`profile_picture_url`	Returns the URL of the post author's profile picture on Threads.

Example Request

curl -s -X GET \
  "https://graph.threads.net/v1.0/me/replies?fields=id,media_product_type,media_type,media_url,permalink,username,text,topic_tag,timestamp,shortcode,thumbnail_url,children,is_quote_post,has_replies,root_post,replied_to,is_reply,is_reply_owned_by_me,reply_audience&since=2023-10-15&until=2023-11-18&limit=1&access_token=<ACCESS_TOKEN>"

Examples Response

{
  "data": [
    {
      "id": "1234567",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "permalink": "https://www.threads.net/@threadsapitestuser/post/abcdefg",
      "username": "threadsapitestuser",
      "text": "Reply Text",
      "topic_tag": "Reply Topic",
      "timestamp": "2023-10-17T05:42:03+0000",
      "shortcode": "abcdefg",
      "is_quote_post": false,
      "has_replies": false,
      "root_post": {
        "id": "1234567890"
      },
      "replied_to": {
        "id": "1234567890"
      },
      "is_reply": true,
      "is_reply_owned_by_me": true,
      "reply_audience": "EVERYONE"
    },
  ],
  "paging": {
    "cursors": {
      "before": "BEFORE_CURSOR",
      "after": "AFTER_CURSOR"
    }
  }
}