This document shows you how to retrieve:
Use the GET /{threads-user-id}/threads
endpoint to return a paginated list of all threads created by a user.
Here's a list of fields that can be returned for each Thread.
Name | Description |
---|---|
|
The media's ID. |
|
Surface where the media is published. In the case of Threads, the value is |
|
The media type for a Threads post will be one of these values: |
|
The post’s media URL. |
|
Permanent link to the post. Will be omitted if the media contains copyrighted material or has been flagged for a copyright violation. |
|
Threads user ID who created the post. |
|
Threads username who created the post. |
|
Represents text for a Threads post. |
|
Post time. The publish date in ISO 8601 format. |
|
Shortcode of the media. |
|
URL of thumbnail. This only shows up for Threads media with video. |
|
List of child posts. This only shows up for carousel posts. |
|
Indicates if the media is a quoted post made by another user. |
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"
{ "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" } } }
You can also use the GET /{threads-media-id}
endpoint to return an individual Threads media object.
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>"
{ "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 }