> ## Documentation Index
> Fetch the complete documentation index at: https://info.bundle.social/llms.txt
> Use this file to discover all available pages before exploring further.

# Threads

> Meta's text app. It's like Twitter, but with Meta's infrastructure and surprisingly decent API.

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](/api-reference/limits#threads) for more details.

### Text & Field Limits

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

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

***

## 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. |

```json theme={null}
{
  "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](/api-reference/analytics).

### 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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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"
}
```