Google Ads API

The Google Ads API ships a new major version (v22, v23, v24...) twice a year with breaking changes. Direct access requires an MCC and a Standard Access application. Zernio handles both the gatekeeping and the migrations, so your integration keeps working.

Get API keyFull documentation
  • Free tier
  • No credit card
  • 99.97% uptime
Sponsoredmeridiantools.comRugged portable SSDs | Free shipping over $30Pocket-size storage that shrugs off rain and drops.
Portable SSDsUSB-C drivesDeals
Google AdsLast 7 days$318

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

Warner Music Group
MoFlo
ClickUp
Readdy
RE/MAX
Moving Monkey®
How it works

Live in three steps, no Google Ads developer approval

1

Profile

default

Google Ads

Connect Google Ads

Sign up for free, get your API key and connect Google Ads ad accounts through our OAuth flow.

2

POST /v1/ads/create

const { data } = await zernio.adcampaigns.createStandaloneAd({
  body: {
    accountId: 'acc_8f2a',
    adAccountId: '1234567890',
    name: 'Spring launch',
    campaignType: 'search',
    goal: 'traffic',
    budgetAmount: 25,
    budgetType: 'daily',
    headline: 'Ship faster with Acme',
    body: 'The platform for product teams. Start free.',
    linkUrl: 'https://acme.com',
    keywords: ['product analytics', 'feature flags'],
    countries: ['US'],
    languages: ['en'],
  },
});

Launch a campaign

Create the campaign, its budget, targeting and creative in one API call.

3

Retargeting

$30/day

Paused

Summer Sale

$40/day

$0.94 CPC

Launch Push

$18/day

$412

Track the results

Spend and results sync back. Pause ads, change budgets and pull reports from the same API.

Endpoints

Google Ads endpoints on one REST API

EndpointWhat it does
POST/v1/ads/createCreate a Search or Display campaign
GET/v1/ads/{id}Get campaign/ad group/ad details and current spend
PUT/v1/ads/{id}Update status, budget, bidding strategy, or schedule
DELETE/v1/ads/{id}Remove a Google Ads entity
GET/v1/ads/{id}/analyticsImpressions, clicks, CTR, CPC, CPM per ad/ad group/campaign
GET/v1/ads/campaignsList all campaigns across connected Google Ads accounts
GET/v1/ads/interestsBrowse geo, language, and keyword targeting criteria
View full API reference
Media specs

What you can upload to Google Ads

Zernio transcodes and optimizes media for Google Ads's requirements automatically.

google-ads/media-specs
TypeFormatMax sizeNotes
Responsive Search AdText15 headlines / 4 descriptions30/90 chars respectively
Responsive DisplayJPEG, PNG5120 KB / assetMultiple ratios: 1.91:1 and 1:1
KeywordText80 charsBROAD, PHRASE, or EXACT match types
Geo targetCriterion ID or country codeN/AQuery /v1/ads/interests to resolve
Capabilities

Everything the API handles for you

Google Ads API has per-developer-token and per-account quotas. Zernio pools across customers and handles 429/RESOURCE_EXHAUSTED responses with exponential backoff. Version migrations (v22 → v23 → v24) are absorbed at our layer.

Search campaigns

Search campaigns with Responsive Search Ads.

Display campaigns

Display campaigns with Responsive Display Ads.

Full hierarchy

Campaign → Ad Group → Ad, managed through one API.

Keyword match types

BROAD, PHRASE, and EXACT match on every keyword.

Geo and language

Target by location and language.

Pause, edit, resume

Change any ad's state with PUT /v1/ads/{id}.

Live metrics

Real-time spend, CPC, and CPM per ad.

No MCC needed

No MCC or Standard Access application required.

Smart Bidding

Maximize Clicks, Maximize Conversions, or ROAS bidding.

Start building with the Google Ads API

Free tier available. No credit card required.

Get free API keyRead the docs
  • Free tier
  • No credit card
  • 99.97% uptime