Engagements2,413
CTR1.18%
Foundry Club@foundryclub
Ad

The Harlow sofa is back in stock.

From foundryclub.com
Promoted post // LaunchCampaign1 adsActive
X AdsLast 7 days$196

X Ads API (Twitter Ads) for Developers

Launch and manage X ad campaigns via API, or hand them to your AI agent over Zernio MCP.

Start Running X AdsView API Docs
  • Campaigns
  • Promoted posts
  • Audiences
  • Analytics

Join 200,000+ of the world's most ambitious developers and builders

Warner Music Group
ClickUp
Vibiz
RE/MAX
ACT.agency
Holo

Why Zernio vs the X Ads API?

Save 4-6 weeks of development

Zernio API

  • No X Ads API application

  • OAuth 1.0a signing handled

  • Promote your scheduled posts

  • A standard Bearer token

  • One API for 8 ad networks

X Ads API

  • An access application that can take weeks

  • OAuth 1.0a signatures on every request

  • Funding instruments and line items to wire up

  • Location IDs to resolve before targeting

  • A separate integration per ad network

How to use the X Ads API with Zernio

Get your first campaign under 10 minutes

1

Profile

default

X Ads

Connect your account

Connect the X account you post from, then pick its ad account. Ads are included on every Zernio account.

2

POST /v1/ads/create

const { data } = await zernio.adcampaigns.createStandaloneAd({
  body: {
    accountId: 'acc_8f2a',
    adAccountId: '18ce54d4x5t',
    name: 'Spring launch',
    goal: 'traffic',
    budgetAmount: 25,
    budgetType: 'daily',
    body: 'Shipping today at Acme',
    linkUrl: 'https://acme.com',
    countries: ['US'],
  },
});

Create or boost a campaign

Pick a post to promote or write a new one, then set a budget, dates and countries. Do it via API or ask your AI agent through Zernio MCP.

3

Retargeting

$30/day

Paused

Summer Sale

$40/day

$0.94 CPC

Launch Push

$18/day

$412

Track and adjust

Pause campaigns, change budgets or pull reports from your app or your agent, without opening X Ads Manager.

Skip the X Ads API application and OAuth 1.0a signing

Features

Everything you need to run X Ads

Campaigns and line items

Campaign, line item and promoted post in one call, with a daily budget and date range.

Custom audiences

Build audiences from hashed emails and include or exclude them on any campaign.

Promote existing posts

Promote any post from your connected X account, including ones scheduled through Zernio.

Spend and results without opening another dashboard

X Ads·Traffic
Metrics
7d14d30d90d
Spend$196.30
Impressions58.1K
Engagements2,413
Clicks688
CTR1.18%
CPM$3.38

Every campaign and its status in one table

NamePlatformStatus
Promoted post // Launch1 ad
active
Website clicks // Pricing2 ads
active
Awareness // US3 ads
active
Promoted post // Changelog1 ad
paused
Engagement // Launch thread1 ad
active

Ad analytics

Spend, impressions, clicks, CTR, CPC, CPM, video views and web conversions over a date range, per campaign and promoted post.

Country targeting

Target campaigns by country, alongside your own audiences.

Campaign control

Pause, resume, rename or delete campaigns and line items, and change budgets.

Integrate

Three ways in. Same API behind all of them

Write it yourself with the SDKs, hand it to an agent over MCP, or run it from a shell.

Read the docs
import Zernio from '@zernio/node';
const zernio = new Zernio(); // reads ZERNIO_API_KEY
const { data: ad } = await zernio.adcampaigns.createStandaloneAd({
body: {
accountId: 'acc_xxx',
adAccountId: '18ce54d4x5t',
name: 'Spring launch',
goal: 'traffic',
budgetAmount: 25,
budgetType: 'daily',
body: 'Shipping today at Acme',
linkUrl: 'https://acme.com',
countries: ['US'],
},
});
And more
Supported Platforms

Build one integration
and run ads on 7 networks with it

Frequently Asked Questions

Learn more

Ads API

Run ads on all 8 networks

X API Reference

Post, thread and reply

X Ads docs

Endpoints, fields and examples

Start running X Ads today

Full REST API for campaigns, promoted posts and audiences.

Start for free
  • SOC 2
  • GDPR compliant
  • 99.97% uptime
  • Under 50ms response