API Reference

Pinterest Ads API

Pinterest's v5 Ads API requires developer registration, app approval for advanced scopes, and ongoing compliance. Zernio wraps Promoted Pin campaigns behind a single REST endpoint.

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 Pinterest Ads accounts.
3.
Start Posting
Make API calls to post content to Pinterest Ads.

Promote an Existing Pin

JavaScript

const response = await fetch('https://zernio.com/api/v1/ads/boost', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    postId: 'POST_ID',
    accountId: 'ACCOUNT_ID',
    adAccountId: '549123456789',
    platform: 'pinterestads',
    name: 'Boost spring decor Pin',
    goal: 'traffic',
    budget: { amount: 30, type: 'daily' },
    schedule: { startDate: '2026-04-20', endDate: '2026-05-20' },
    targeting: {
      age_groups: ['25-34', '35-44'],
      genders: ['female', 'unknown'],
      locations: ['US', 'CA', 'GB']
    }
  })
});

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

Pinterest Ads Endpoints

POST/v1/ads/create

Create a Campaign → Ad Group → Pin ad on Pinterest

POST/v1/ads/boost

Promote an existing organic Pin as Promoted content

GET/v1/ads/{id}

Get ad status, spend, and creative

PUT/v1/ads/{id}

Update budget, status, or schedule

GET/v1/ads/{id}/analytics

Spend, impressions, saves, closeups, clicks

GET/v1/ads/campaigns

List campaigns across connected Pinterest ad accounts

View full API reference →

Media Requirements

Type	Format	Max Size	Notes
Standard Pin	JPEG, PNG	20 MB	Recommended 1000x1500 (2:3)
Video Pin	MP4, MOV, M4V	2 GB	4 sec to 15 min, 9:16 or 1:1
Title / Description	Text	100 / 500 chars	Pin metadata

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

API Limits

Pinterest v5 API applies per-app and per-ad-account rate limits. Zernio pools across customers and handles 429 responses with exponential backoff.

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

Features

✓Campaign → Ad Group → Pin ad hierarchy
✓Awareness, traffic, and video-view objectives
✓Promote existing organic Pins
✓Demographic and interest targeting
✓Save and closeup metrics (native to Pinterest)
✓Pause, edit, and resume via PUT /v1/ads/{id}
✓Real-time spend and funnel analytics

Response Example

Create a Promoted Pin 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": "pinterestads",
    "accountId": "acc_pinterestads_123",
    "adAccountId": "549123456789",
    "name": "Spring home decor",
    "goal": "traffic",
    "budget": { "amount": 30, "type": "daily" },
    "schedule": { "startDate": "2026-04-20" },
    "creative": {
      "pinId": "123456789012345678",
      "landingPageUrl": "https://example.com/spring-decor"
    },
    "targeting": {
      "age_groups": ["25-34", "35-44"],
      "locations": ["US", "CA"],
      "interests": ["home_decor", "diy_projects"]
    }
  }'

Start building with Pinterest Ads API

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

Get Free API Key Read Documentation →