Twitter Ads (X Ads)

ads-api.twitter.com

Community

The X (Twitter) Ads API lets you programmatically create, manage, and measure advertising campaigns on the X platform. Use it to manage campaigns, line items (ad groups), creatives, promoted posts, audience targeting, and pull analytics reports on campaign performance.

Auth

api_key

Pricing

free

Spec version

1.0

Base URL

https://ads-api.twitter.com

Crawl failures

1

Last verified

2026-03-01T11:55:04.000Z

Health

This is a community-maintained manifest. Health monitoring is not available because this service doesn't host its own /.well-known/agent endpoint yet. Learn more about trust levels →

Capabilities

get_campaign_analytics

Retrieve performance analytics for campaigns, line items, or promoted tweets. Metrics include impressions, engagements, clicks, spend, and conversions.

Detail: https://ads-api.twitter.com/capabilities/get_campaign_analytics

manage_audiences

Create and manage custom (tailored) audiences by uploading email lists, device IDs, or Twitter user IDs. Use audiences for targeting or exclusion.

Detail: https://ads-api.twitter.com/capabilities/manage_audiences

manage_campaigns

Create, update, pause, or delete ad campaigns. Configure campaign objective, budget, start/end dates, and funding instrument.

Detail: https://ads-api.twitter.com/capabilities/manage_campaigns

manage_creatives

Create and manage promoted tweets, cards, and media creatives. Associate creatives with line items to serve them in campaigns.

Detail: https://ads-api.twitter.com/capabilities/manage_creatives

manage_line_items

Create, update, or delete line items (ad groups) within a campaign. Set bid amount, optimization goal, placement, and audience targeting.

Detail: https://ads-api.twitter.com/capabilities/manage_line_items

manage_targeting

Set targeting criteria on line items including location, gender, age, interests, keywords, followers look-alikes, and custom audiences.

Detail: https://ads-api.twitter.com/capabilities/manage_targeting

Agent Preview

This is what an AI agent sees when it discovers this service via the Gateway:

Service: Twitter Ads (X Ads)
Description: The X (Twitter) Ads API lets you programmatically create, manage, and measure advertising campaigns on the X platform. Use it to manage campaigns, line items (ad groups), creatives, promoted posts, audience targeting, and pull analytics reports on campaign performance.
Auth: api_key
Capabilities:
  - get_campaign_analytics: Retrieve performance analytics for campaigns, line items, or promoted tweets. Metrics include impressions, engagements, clicks, spend, and conversions.
  - manage_audiences: Create and manage custom (tailored) audiences by uploading email lists, device IDs, or Twitter user IDs. Use audiences for targeting or exclusion.
  - manage_campaigns: Create, update, pause, or delete ad campaigns. Configure campaign objective, budget, start/end dates, and funding instrument.
  - manage_creatives: Create and manage promoted tweets, cards, and media creatives. Associate creatives with line items to serve them in campaigns.
  - manage_line_items: Create, update, or delete line items (ad groups) within a campaign. Set bid amount, optimization goal, placement, and audience targeting.
  - manage_targeting: Set targeting criteria on line items including location, gender, age, interests, keywords, followers look-alikes, and custom audiences.