X (Twitter)

X Ads API

The X Ads API enables programmatic management of advertising campaigns on the X platform including campaign creation and scheduling, custom audience building, creative management (draft posts, cards, media), and analytics retrieval for campaign performance metrics. Supports both synchronous and asynchronous analytics endpoints for reporting.

GitHub

Documentation

📖
Documentation
https://docs.x.com/x-ads-api
📖
GettingStarted
https://docs.x.com/x-ads-api/getting-started/create-a-campaign
📖
RateLimits
https://docs.x.com/x-ads-api/fundamentals/rate-limiting

Other Resources

🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/postman/x-ads-api-postman-collection.json

API entry from apis.yml

apis.yml Raw ↑ 
aid: twitter:x-ads-api
name: X Ads API
description: The X Ads API enables programmatic management of advertising campaigns on the X platform
  including campaign creation and scheduling, custom audience building, creative management (draft posts,
  cards, media), and analytics retrieval for campaign performance metrics. Supports both synchronous and
  asynchronous analytics endpoints for reporting.
image: https://abs.twimg.com/favicons/twitter.ico
humanURL: https://docs.x.com/x-ads-api
baseURL: https://ads-api.x.com
properties:
- type: Documentation
  url: https://docs.x.com/x-ads-api
- type: GettingStarted
  url: https://docs.x.com/x-ads-api/getting-started/create-a-campaign
- type: RateLimits
  url: https://docs.x.com/x-ads-api/fundamentals/rate-limiting
- type: PostmanCollection
  url: postman/x-ads-api-postman-collection.json
tags:
- Advertising
- Campaigns
- Analytics
- Audiences
- Creatives