Threads API Integration - Meta's Text Platform

Threads is the new kid on the block, integrated tightly with Instagram’s infrastructure. The API is surprisingly decent for a platform this young.

Supported Content Types

Text Posts: Text only, or text with images/videos. 0-10 files.
Mixed Media: Images and videos can be combined in the same post. Up to 10 items.

Quirks & Gotchas

Terminology

Comments are called Replies in Threads-land.
Shares include both Reposts and Quotes. We combine them into one number.

Date Restrictions

Threads requires posts to be after April 2024 for analytics. Older imported posts won’t have analytics data.

Media Limits

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

See Platform Limits for more details.

Text & Field Limits

Field	Limit
`text`	Max 500 characters
`altText`	Optional. Accessibility description for image media in the post.

Alt text applies to image items Threads publishes through our API. Videos use platform-specific behavior; set alt text when you are posting images.

Post Options

Send Threads-specific options inside data.THREADS.

Field	Type	Description
`text`	`string`	Post text. Max 500 characters.
`uploadIds`	`string[]`	Up to 10 uploaded media files. Images and videos can be mixed.
`mediaItems`	`array`	Optional per-media metadata. Use it to attach `altText` to image uploads.

{
  "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"
        }
      ]
    }
  }
}

Analytics

For general analytics concepts (refresh rates, data retention, what “Returns 0” means), see the Analytics Overview.

Profile Analytics

Period: Rolling window.

Metric	Description	Note
`impressions`	Content impressions	Internally contains quote count from API
`impressionsUnique`	Unique impressions	Internally contains repost count from API
`views`	Views
`viewsUnique`	-	Same as views
`likes`	Likes
`comments`	Replies
`postCount`	Total posts
`followers`	Followers
`following`	-	Returns `0` (not provided by Threads API)

Post Analytics

Period: Lifetime.

Metric	Description	Note
`impressions`	Views
`impressionsUnique`	-	Same as impressions
`views`	Views	Same as impressions
`viewsUnique`	-	Same as views
`likes`	Likes
`comments`	Replies
`shares`	Reposts + Quotes	Combined into one number

Quirks

Views metric is used for both impressions and views (they are the same value).
Comments are called “replies” in Threads.
Shares include both reposts and quotes - we don’t split them.
For profile analytics: the impressions field internally contains quote counts and impressionsUnique contains repost counts. This is how the Threads API returns data.
Following count is not available through the Threads API.

Raw Analytics

Threads profile raw analytics are stored as the metrics we get back from Threads, plus a post count.

{
  "likes": 420,
  "replies": 38,
  "views": 12400,
  "followers_count": 3100,
  "reposts": 55,
  "quotes": 12,
  "allProfilePosts": 84
}

Post raw analytics store the Threads media/post payload we fetched for that item.

{
  "id": "17890000000000000",
  "media_type": "IMAGE",
  "media_product_type": "THREADS",
  "permalink": "https://www.threads.net/@example/post/abc",
  "username": "example",
  "text": "A quick launch note",
  "timestamp": "2026-04-26T10:30:00+0000"
}

API Documentation

Platforms

Guides

Endpoints

Threads

Supported Content Types

Quirks & Gotchas

Terminology

Date Restrictions

Media Limits

Text & Field Limits

Post Options

Analytics

Profile Analytics

Post Analytics

Quirks

Raw Analytics

​Supported Content Types

​Quirks & Gotchas

​Terminology

​Date Restrictions

​Media Limits

​Text & Field Limits

​Post Options

​Analytics

​Profile Analytics

​Post Analytics

​Quirks

​Raw Analytics

Supported Content Types

Quirks & Gotchas

Terminology

Date Restrictions

Media Limits

Text & Field Limits

Post Options

Analytics

Profile Analytics

Post Analytics

Quirks

Raw Analytics