# X Ads API

**Canonical:** https://apis.io/apis/twitter/x-ads-api/  
**Provider:** X (Twitter) — https://apis.io/providers/twitter/  
**Base URL:** https://ads-api.x.com  
**Documentation:** https://docs.x.com/x-ads-api

X Ads API is one of 23 APIs that [X (Twitter)](https://apis.io/providers/twitter/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Advertising, Campaigns, Analytics, Audiences, and Creatives. The published artifact set on APIs.io includes API documentation, a getting-started guide, and rate-limit docs.

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.

## Machine-readable artifacts (23)

- **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
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/apis.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-bookmark-and-remove-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-create-list-add-member-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-follow-list-by-id-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-follow-user-by-username-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-followers-of-handle-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-liked-posts-of-handle-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-list-detail-and-members-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-mentions-of-handle-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-mute-user-by-username-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-pin-owned-list-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-post-engagement-audit-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-post-like-cleanup-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-quote-post-from-search-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-reply-to-latest-post-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-repost-then-undo-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-reposters-of-latest-post-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-search-recent-get-details-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-unfollow-user-by-username-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-user-lookup-recent-posts-workflow.yml

## Other X (Twitter) APIs (12)

- [X Activity API](https://apis.io/apis/twitter/x-activity-api/)
- [X (Twitter) Account Activity API](https://apis.io/apis/twitter/twitter-account-activity-api/)
- [X (Twitter) Activity API](https://apis.io/apis/twitter/twitter-activity-api/)
- [X (Twitter) Bookmarks API](https://apis.io/apis/twitter/twitter-bookmarks-api/)
- [X (Twitter) Chat API](https://apis.io/apis/twitter/twitter-chat-api/)
- [X (Twitter) Communities API](https://apis.io/apis/twitter/twitter-communities-api/)
- [X (Twitter) Community Notes API](https://apis.io/apis/twitter/twitter-community-notes-api/)
- [X (Twitter) Compliance API](https://apis.io/apis/twitter/twitter-compliance-api/)
- [X (Twitter) Connections API](https://apis.io/apis/twitter/twitter-connections-api/)
- [X (Twitter) Direct Messages API](https://apis.io/apis/twitter/twitter-direct-messages-api/)
- [X (Twitter) General API](https://apis.io/apis/twitter/twitter-general-api/)
- [X (Twitter) Likes API](https://apis.io/apis/twitter/twitter-likes-api/)

## Tags

Advertising, Campaigns, Analytics, Audiences, Creatives

---

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