Twitter/X Ads API
Programmatic interface to create, manage, and report on Twitter/X ad campaigns including Promoted Tweets, Promoted Accounts, and Takeover placements.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
All traffic over TLS. OAuth 1.0a requires four secrets (consumer key, consumer secret, access token, access token secret) all of which must be stored securely server-side — this is a significant secret management burden. OAuth 2.0 scopes are more granular but limited to read operations for ads. Security posture of the platform has been uncertain since 2022 ownership changes.
⚡ Reliability
Best When
You have an approved Twitter/X Ads API partner relationship and need to run real-time or event-driven campaigns tied to trending topics or live events.
Avoid When
You need reliable programmatic access without a lengthy approval process, or your use case requires the stability and predictability that Twitter/X has not demonstrated since 2022.
Use Cases
- • Automate campaign creation for product launches or event-based promotions tied to trending topics
- • Pull campaign performance metrics including engagement rate and video view data for reporting
- • Adjust campaign budgets and bids programmatically based on real-time engagement signals
- • Manage Tailored Audiences by uploading and syncing email or device ID lists
- • Monitor promoted tweet performance and pause ads with below-threshold engagement rates
Not For
- • Programmatic advertising at high scale — Twitter/X Ads API access is heavily restricted and not suitable for high-volume automated systems without an approved partner relationship
- • B2B professional targeting comparable to LinkedIn — Twitter's audience targeting is interest and behavior-based, not professional attribute-based
- • Long-term automated campaign management without ongoing manual oversight given platform instability and policy changes since 2022
Interface
Authentication
Requires OAuth 1.0a for most Ads API endpoints (OAuth 2.0 Bearer Token is read-only). Ads API access requires applying for Elevated access on the developer portal and then separately requesting Ads API access — standard developer accounts do not have ads write access. The approval process is manual and can take weeks, and Twitter/X has significantly restricted new partner approvals since 2022. Ads API access may require a managed partner agreement for large-scale use.
Pricing
No API usage fees for approved partners. Ad spend is billed to the Twitter/X Ads account. Basic API access requires Elevated access ($100/month as of 2023 pricing changes) plus a separate Ads API approval. Pricing and access tiers have changed frequently since 2022 and should be verified directly with Twitter/X.
Agent Metadata
Known Gotchas
- ⚠ Ads API access requires Elevated API access plus a separate Ads API approval — these are two distinct approval processes, both manual, and Twitter/X has severely restricted new Ads API approvals since 2022; many applications are denied without explanation
- ⚠ OAuth 1.0a is required for write operations — the newer OAuth 2.0 Bearer Token only grants read access, meaning agents must implement the older and more complex OAuth 1.0a signing process including request signing with consumer key and access token secrets
- ⚠ Platform instability and undocumented breaking changes since 2022 mean that working integrations can break without notice — agents should implement robust health checks and alerting rather than assuming continuous availability
- ⚠ Ad review and moderation policies have changed frequently and are applied inconsistently — campaigns that ran successfully previously may be rejected under new policies, and the rejection reason may not be specific enough to action without manual review
- ⚠ Analytics data is subject to a 72-hour finalization window — engagement and conversion metrics for recent days are preliminary and will change, so agents pulling performance data should account for data revisions when making optimization decisions
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for Twitter/X Ads API.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-07.