Threads Meta's text app — surprisingly decent API.
Meta's text app. It's like Twitter, but with Meta's infrastructure and a
surprisingly capable API for such a young platform — it integrates tightly with
Instagram's infrastructure.
Text-only posts, or text combined with images/videos (0–10 files).
Mixed media posts combining images and videos in a single post (up to 10 items).
Comments are referred to as "Replies" in Threads.
Shares encompass both Reposts and Quotes, combined into a single metric.
Threads requires posts to be after April 2024 for analytics. Older imported posts
won't have analytics data.
Constraint Value Files 0–10 (images and/or videos, mixed allowed) Video max bitrate 100 Mbps Video aspect ratio 0.01:1 to 1.91:1 Image max size 8 MB Image width 320–1440px Image aspect ratio 0.01:1 to 1.91:1
Field Limit textMax 500 characters altTextOptional accessibility description for image media in the post
Send Threads-specific options within data.THREADS.
Field Type Description textstringPost text, maximum 500 characters. uploadIdsstring[]Up to 10 uploaded media files, images and videos mixed. mediaItemsarrayOptional per-media metadata to attach altText to images.
{ "teamId" : "team_123" , "title" : "Threads launch post" , "status" : "SCHEDULED" , "postDate" : "2026-06-01T15:00:00.000Z" , "socialAccountTypes" : [ "THREADS" ], "data" : { "THREADS" : { "text" : "A quick launch note" , "uploadIds" : [ "upload_image_123" ], "mediaItems" : [ { "uploadId" : "upload_image_123" , "altText" : "Product screen on a phone" } ] } } } Metric Description Note impressionsContent impressions Internally contains quote count from API impressionsUniqueUnique impressions Internally contains repost count from API viewsViews viewsUnique— Same as views likesLikes commentsReplies postCountTotal posts followersFollowers following— Returns 0 (not provided by API)
Metric Description Note impressionsViews impressionsUnique— Same as impressions viewsViews Same as impressions viewsUnique— Same as views likesLikes commentsReplies sharesReposts + Quotes Combined into one number
Views serve as both impressions and views (identical values).
Comments are labeled as "replies" on the platform.
Shares combine reposts and quotes without separation.
Profile impressions internally contain quote counts; impressionsUnique
contains repost counts.
Following count is unavailable through the Threads API.
