# X Media API

**Canonical:** https://apis.io/apis/x/x-media-api/  
**Provider:** X — https://apis.io/providers/x/  
**Base URL:** https://api.x.com  
**Documentation:** https://docs.x.com/x-api/media/introduction

X Media API is one of 23 APIs that [X](https://apis.io/providers/x/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Media. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Endpoints related to retrieving and uploading Media — 11 operation(s) in the X-published contract.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/2/media` | Get Media by media keys |
| GET | `/2/media/analytics` | Get Media analytics |
| POST | `/2/media/metadata` | Create Media metadata |
| DELETE | `/2/media/subtitles` | Delete Media subtitles |
| POST | `/2/media/subtitles` | Create Media subtitles |
| GET | `/2/media/upload` | Get Media upload status |
| POST | `/2/media/upload` | Upload a media file and get back its identifiers, including a media_key. The media field carries the file content base64-encoded in JSON bodies (raw bytes in... |
| POST | `/2/media/upload/initialize` | Initialize media upload |
| POST | `/2/media/upload/{id}/append` | Append Media Upload |
| POST | `/2/media/upload/{id}/finalize` | Finalize Media upload |
| GET | `/2/media/{media_key}` | Get Media by media key |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-media-api-openapi.yml
- **Documentation** — https://docs.x.com/x-api/media/introduction

## Other X APIs (12)

- [X Account Activity API](https://apis.io/apis/x/x-account-activity-api/)
- [X Account API](https://apis.io/apis/x/x-account-api/)
- [X Activity API](https://apis.io/apis/x/x-activity-api/)
- [X Articles API](https://apis.io/apis/x/x-articles-api/)
- [X Bots API](https://apis.io/apis/x/x-bots-api/)
- [X Broadcasts API](https://apis.io/apis/x/x-broadcasts-api/)
- [X Chat API](https://apis.io/apis/x/x-chat-api/)
- [X Communities API](https://apis.io/apis/x/x-communities-api/)
- [X Community Notes API](https://apis.io/apis/x/x-community-notes-api/)
- [X Compliance API](https://apis.io/apis/x/x-compliance-api/)
- [X Connections API](https://apis.io/apis/x/x-connections-api/)
- [X Direct Messages API](https://apis.io/apis/x/x-direct-messages-api/)

## Tags

Media

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/x/x-media-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/x/.