# X (Twitter) API guide

> Publish posts with up to four images to X. Platform key: twitter.

**Source:** https://postprism.app/docs/platforms/twitter  
**Updated:** 2026-10-10

---

|   |   |
| --- | --- |
| Platform key | `twitter` |
| Text limit | 280 characters, including hashtags |
| Media | Up to 4 images. Videos are not posted to X. |

## Things to know

- The platform key is `twitter`.
- Text over 280 characters (with hashtags) is cut and ends with an ellipsis, so write the X version to fit.

## Example

**POST /api/v1/posts**

```
{
  "base_content": "Our autumn menu is here.",
  "platforms": ["twitter"],
  "platform_content": {
    "twitter": {
      "content": "Our autumn menu is here. Which drink first?"
    }
  },
  "scheduled_at": "2026-10-16T09:30:00Z"
}
```

Other platforms: [LinkedIn](https://postprism.app/docs/platforms/linkedin), [TikTok](https://postprism.app/docs/platforms/tiktok), [YouTube](https://postprism.app/docs/platforms/youtube), [Pinterest](https://postprism.app/docs/platforms/pinterest), [Bluesky](https://postprism.app/docs/platforms/bluesky). Writing limits for every network are in our [character limit](https://postprism.app/glossary/character-limit) reference, and the [X (Twitter) scheduler](https://postprism.app/platforms/twitter-scheduler) page covers scheduling from the app.