Threads Posts

• Single Thread Posts
• Carousel Posts
• Topic Tags, Links, and GIFs
• Media Specifications

1. Create a media container with text only or with an image or video hosted on your public server with optional text using the POST /{threads-user-id}/threads endpoint.
2. Publish the media container using the POST /{threads-user-id}/threads_publish endpoint.

• Text posts are limited to 500 characters.
• Emojis are counted as the number of UTF-8 bytes⁠.

curl -i -X POST \
  -d "media_type=IMAGE" \
  -d "image_url=<IMAGE_URL>" \
  -d "text=<TEXT>" \
  -d "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads"

{
  "id": "<THREADS_MEDIA_CONTAINER_ID>"
}

curl -i -X POST \
  -d "creation_id=<MEDIA_CONTAINER_ID>" \
  -d "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads_publish"

{
  "id": "<THREADS_MEDIA_ID>"
}

1. Create the individual media containers for each image and video that should appear in the carousel using the POST /{threads-user-id}/threads endpoint.
2. Create a single carousel container to contain the media containers using the POST /{threads-user-id}/threads endpoint.
3. Publish the carousel container using the POST /{threads-user-id}/threads_publish endpoint.

• Carousels are limited to 20 images, videos, or a mix of the two.
• Carousels require a minimum of two children.

curl -i -X POST \
  -d "image_url=<IMAGE_URL>" \
  -d "is_carousel_item=true" \
  -d "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads"

{
  "id": "<THREADS_MEDIA_CONTAINER_ID>"
}

curl -i -X POST \
  -d "media_type=CAROUSEL" \
  -d "children=<MEDIA_ID_1>,<MEDIA_ID_2>,<MEDIA_ID_3>,..." \
  -d "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads"

{
  "id": "<THREADS_CAROUSEL_CONTAINER_ID>"
}

curl -i -X POST \
  -d "creation_id=<MEDIA_CONTAINER_ID>" \
  -d "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads_publish"

{
  "id": "<THREADS_MEDIA_ID>"
}

Using the topic_tag parameter

• Periods (.)
• Ampersands (&)

Example request

curl -i -X POST \
  -d "media_type=TEXT" \
  -d "text=<Text>" \
  -d "access_token=<ACCESS_TOKEN>" \
  -d "topic_tag=<TAG>" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads"

• Valid tags start with a hash sign (#).
• The text is also configured in the app without the hash sign.
• Topic must be at least 1 character and no more than 50 characters long.
• Whole numbers that are preceded by a hash sign (i.e., #1) will not be converted into a tag. This is because it is assumed that # is signifying a number sign in this scenario.
• The following characters are not allowed when using in-text tags with the Threads API, so any in-text tag that starts with a hash sign will end just before these characters:
• Spaces, Tabs, New Line Characters
• Periods (.)
• Ampersands (&)
• At Signs (@)
• Exclamation Marks (!)
• Question Marks (?)
• Commas (,)
• Semi-Colons (;)
• Colons (:)

• This feature is only available for text-only posts. It will not work with image, video, or carousel posts.
• The number of links is restricted to 5 or fewer.

Example request

curl -i -X POST \
  -d "media_type=TEXT" \
  -d "text=<TEXT>" \
  -d "access_token=<ACCESS_TOKEN>" \
  -d "link_attachment=<URL> \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads"

Example response

{
  "id": "<THREADS_MEDIA_CONTAINER_ID>"
}

Example request

curl -s -X GET \
"https://graph.threads.com/v1.0/<THREADS_MEDIA_ID>?fields=id,link_attachment_url&access_token=<ACCESS_TOKEN>"

Example response

{
   "id": "<THREADS_MEDIA_ID>",
   "link_attachment_url": "<LINK_ATTACHMENT_URL>",
}

• This feature is only available for text-only posts. It will not work on image, video, or carousel posts.
• GIPHY⁠ is currently the only available GIF provider.

Example request

curl -i -X POST \
  -d "media_type=TEXT" \
  -d "text=<Text> \
  -d "access_token=<ACCESS_TOKEN>" \
  -d "gif_attachment={"gif_id":"<GIF_ID>","provider":"GIPHY"}" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads"

Example response

{
 "id": "<THREADS_MEDIA_ID>"
}

• Format: JPEG and PNG image types are the officially supported formats for image posts.
• File Size: 8 MB maximum.
• Aspect Ratio Limit: 10:1
• Minimum Width: 320 (will be scaled up to the minimum if necessary)
• Maximum Width: 1440 (will be scaled down to the maximum if necessary)
• Height: Varies (depending on width and aspect ratio)
• Color Space: sRGB. Images using other color spaces will have their color spaces converted to sRGB.

• Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, moov atom at the front of the file.
• Audio Codec: AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
• Video Codec: HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
• Frame Rate: 23-60 FPS
• Picture Size:
  • Maximum Columns (horizontal pixels): 1920
  • Required aspect ratio is between 0.01:1 and 10:1 but we recommend 9:16 to avoid cropping or blank space.
• Video Bitrate: VBR, 100 Mbps maximum.
• Audio Bitrate: 128 kbps.
• Duration: 300 seconds (5 minutes) maximum, minimum longer than 0 seconds.
• File Size: 1 GB maximum.

• Reposts
• Quote Posts
• Polls
• Spoilers
• Text Attachments