API Reference

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 Key Full Documentation

Quick Start

1.
Get API Key
Sign up for free and get your API key in seconds.
2.
Connect Account
Use our OAuth flow to connect Google Ads accounts.
3.
Start Posting
Make API calls to post content to Google Ads.

Create a Search Campaign

JavaScript

const response = await fetch('https://zernio.com/api/v1/ads/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    platform: 'googleads',
    accountId: 'acc_googleads_123',
    adAccountId: '987-654-3210',
    name: 'US DevOps Search',
    campaignType: 'SEARCH',
    goal: 'traffic',
    budget: { amount: 50, type: 'daily' },
    schedule: { startDate: '2026-04-20' },
    targeting: {
      geoTargets: ['US', 'CA', 'GB'],
      languages: ['en'],
      keywords: [
        { text: 'platform engineering tools', matchType: 'BROAD' },
        { text: 'internal developer platform', matchType: 'PHRASE' }
      ]
    },
    creative: {
      headlines: [
        'Build your Developer Platform',
        'Ship DevEx Faster',
        'Internal Platforms, Done Right'
      ],
      descriptions: [
        'Spec-driven internal platform. Free tier available.',
        'Backstage + Terraform, managed. 14-day trial.'
      ],
      landingPageUrl: 'https://example.com/platform'
    }
  })
});

const ad = await response.json();
console.log(ad.ad.platformAdId);

Google Ads Endpoints

POST/v1/ads/create

Create 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}/analytics

Impressions, clicks, CTR, CPC, CPM per ad/ad group/campaign

GET/v1/ads/campaigns

List all campaigns across connected Google Ads accounts

GET/v1/ads/interests

Browse geo, language, and keyword targeting criteria

View full API reference →

Media Requirements

Type	Format	Max Size	Notes
Responsive Search Ad	Text	15 headlines / 4 descriptions	30/90 chars respectively
Responsive Display	JPEG, PNG	5120 KB / asset	Multiple ratios: 1.91:1 and 1:1
Keyword	Text	80 chars	BROAD, PHRASE, or EXACT match types
Geo target	Criterion ID or country code	N/A	Query /v1/ads/interests to resolve

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

API Limits

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.

Zernio handles all rate limiting automatically. We queue and retry requests as needed.

Features

✓Search campaigns with Responsive Search Ads
✓Display campaigns with Responsive Display Ads
✓Campaign → Ad Group → Ad hierarchy
✓Keyword match types (BROAD / PHRASE / EXACT)
✓Geo and language targeting
✓Smart Bidding strategies (Maximize Clicks / Conversions / ROAS)
✓Pause, edit, and resume via PUT /v1/ads/{id}
✓Real-time spend, CPC, CPM per ad
✓No MCC or Standard Access application required

Response Example

Create a Display Campaign

cURL

curl -X POST "https://zernio.com/api/v1/ads/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "googleads",
    "accountId": "acc_googleads_123",
    "adAccountId": "987-654-3210",
    "name": "Retargeting Display",
    "campaignType": "DISPLAY",
    "goal": "conversions",
    "budget": { "amount": 40, "type": "daily" },
    "schedule": { "startDate": "2026-04-20" },
    "targeting": { "geoTargets": ["US"], "languages": ["en"] },
    "creative": {
      "headlines": ["Finish your signup", "Get 30% off this week"],
      "descriptions": ["Come back and upgrade today."],
      "imageUrls": ["https://cdn.example.com/retarget-1200x628.jpg"],
      "landingPageUrl": "https://example.com/upgrade"
    }
  }'

Start building with Google Ads API

Free tier available · No credit card required · 99.97% uptime

Get Free API Key Read Documentation →