Retrieve Threads Media Objects

This document shows you how to retrieve:

Retrieve a List of All a User's Threads

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

Fields

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

NameDescription

id (default)

The media's ID.

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 post will be one of these values: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM, AUDIO, or REPOST_FACADE.

media_url

The post’s media URL.

permalink

Permanent link to the post. Will be omitted if the media contains copyrighted material or has been flagged for a copyright violation.

owner

Threads user ID who created the post.

username

Threads username who created the post.

text

Represents text for a Threads post.

timestamp

Post time. The publish date in ISO 8601 format.

shortcode

Shortcode of the media.

thumbnail_url

URL of thumbnail. This only shows up for Threads media with video.

children

List of child posts. This only shows up for carousel posts.

is_quote_post

Indicates if the media is a quoted post made by another user.

Example Request

curl -s -X GET \
"https://graph.threads.net/v1.0/me/threads?fields=id,media_product_type,media_type,media_url,permalink,owner,username,text,timestamp,shortcode,thumbnail_url,children,is_quote_post&since=2023-10-15&until=2023-11-18&limit=1&access_token=$THREADS_ACCESS_TOKEN"

Example Response

{
  "data": [
    {
      "id": "1234567",
      "media_product_type": "THREADS",
      "media_type": "TEXT_POST",
      "permalink": "https://www.threads.net/@threadsapitestuser/post/abcdefg",
      "owner": {
        "id": "1234567"
      },
      "username": "threadsapitestuser",
      "text": "Today Is Monday",
      "timestamp": "2023-10-17T05:42:03+0000",
      "shortcode": "abcdefg",
      "is_quote_post": false
    },
  ],
  "paging": {
    "cursors": {
      "before": "BEFORE_CURSOR",
      "after": "AFTER_CURSOR"
    }
  }
}

Retrieve a Single Threads Media Object

You can also use the GET /{threads-media-id} endpoint to return an individual Threads media object.

Example Request

curl -s -X GET \
"https://graph.threads.net/v1.0/<THREADS_MEDIA_ID>?fields=id,media_product_type,media_type,media_url,permalink,owner,username,text,timestamp,shortcode,thumbnail_url,children,is_quote_post&access_token=<THREADS_ACCESS_TOKEN>"

Example Response

{
  "id": "1234567",
  "media_product_type": "THREADS",
  "media_type": "TEXT_POST",
  "permalink": "https://www.threads.net/@threadsapitestuser/post/abcdefg",
  "owner": {
    "id": "1234567"
  },
  "username": "threadsapitestuser",
  "text": "Hello World",
  "timestamp": "2023-10-09T23:18:27+0000",
  "shortcode": "abcdefg",
  "is_quote_post": false
}