PluggzyDocs

X Ads

InsightsBoostsTargetingAudiences
InsightsBoostsTargetingAudiences

Your X ads in any AI app: read spend and results, create campaigns, promote posts, change budgets and bids, and target by place, interests and Tailored Audiences. Anything that can spend waits for your yes.

Connect X Ads
Connect with
Two sign-ins: your X account, then its ads
Structure
Campaign › Line item › Promoted tweet
Tools
3
Nonelimits of Pluggzy’s own: no daily cap, no spacing
Exactwait when the network says slow down, to the second
Pausednew ads, unless you say launch
Your yesbefore anything that spends or gives access

What works

What your AI app can do on a X Ads account, from the network’s own API.

CreateCampaigns, line items and promoted posts, each with a goal.engagementtrafficawarenessvideo_viewsapp_promotion
Boost a postPromote one of your posts, with its own media.
BudgetsDaily or lifetime, on the line item; a lifetime budget needs an endDate.
BiddingThe bid can change after launch.
TargetingCountry, region, metro, city, postal code, interests, custom audiences, age (X’s ranges), gender and language. With reach estimates.
After launchStatus, budget and bid only.
AudiencesTailored Audiences, once 100 or more users match.
Not hereNo dry run, no targeting search, no lead forms, and no Conversions API (X Pixel only).

Limits

Pluggzy adds no limits of its own to a X Ads ad account: no daily cap, no per-minute cap, no spacing. A change goes out as soon as your AI app asks. Only the network’s own rate limits apply.

ActionPluggzy’s own limitTools
Readsspend, results, insights, leadsNonethe network’s own rate limits applyads_read
Spending changesnew ads, boosts, budgets, bids, resumingNonethe network’s own rate limits applyads_write
Other changespausing, audiences, creatives, keywords, conversionsNonethe network’s own rate limits applyads_write
Deletionscampaigns, ad sets, ads, audiencesNonethe network’s own rate limits applyads_write
ReadsNone
spend, results, insights, leads
the network’s own rate limits apply
ads_read
Spending changesNone
new ads, boosts, budgets, bids, resuming
the network’s own rate limits apply
ads_write
Other changesNone
pausing, audiences, creatives, keywords, conversions
the network’s own rate limits apply
ads_write
DeletionsNone
campaigns, ad sets, ads, audiences
the network’s own rate limits apply
ads_write
  • When a network says slow down, Pluggzy waits exactly the time it asks, to the second, and answers rate_limited with retry_after_seconds. Your AI app calls again after it. Nothing is queued behind your back.
  • Spend, budgets and results come in the ad account’s own currency.
  • Pausing never waits for a yes.

Connect X Ads

Two sign-ins on X, from your Pluggzy dashboard: your X account, then its ads.

  1. 1In your Pluggzy dashboard, choose Connect an account and pick X Ads.
  2. 2Choose Continue with X and approve your X account, then approve access to X Ads on the second screen.
  3. 3You come back to Pluggzy and the ad account shows up.
  4. 4Ask your AI app: “How did my X ads do this week?”

Tools

Exactly what your AI app receives from tools/list. The same three tools work on every ad network.

3 tools · 2 read · 1 write
Ads3
The same tools on every ad networkads_operations, ads_read and ads_write work the same on all nine networks; an operation that isn’t on X Ads is refused with unsupported.
Ads tools
Generated from pluggzy.com/api/docs · 42 toolsSomething unclear? Write to support · Status