Pinterest Ads API for Developers

Launch Promoted Pin campaigns and manage ad accounts through one REST endpoint. Skip the Pinterest developer approval process.

Start Running Pinterest Ads View API Docs

ℹ️

No Pinterest Developer Approval

Direct API access requires registering as a Pinterest developer, getting an app approved for advanced scopes, and ongoing compliance. Zernio handles that so you can create campaigns via REST immediately.

Key Features

Promoted Pin Campaigns

Campaign → Ad Group → Pin hierarchy. Awareness, traffic, and video view objectives.

Boost Existing Pins

Promote any organic Pin as Promoted Pin content without creating a new creative.

Targeting

Age, gender, location, language, and interest categories. Customer-list audiences supported.

Ad Analytics

Spend, impressions, saves, closeups, clicks, and CPC/CPM per campaign and per Pin.

REST Interface

Simple Bearer token auth. Same API key that manages your organic Pinterest scheduling.

Multi-Platform Reach

Cross-post the same asset as Promoted Pin + Meta Ads + TikTok Ads in parallel.

From Zero to Promoted Pin

1.
Enable the Ads Add-On
Turn on Ads in billing. Build, Accelerate, or Unlimited plan.
2.
Connect Pinterest Business
OAuth with a Pinterest Business account that has a connected ad account. No separate developer approval.
3.
POST to /v1/ads/create
Create campaigns, promote Pins, pull analytics. REST end-to-end.

Why Zernio for Pinterest Ads

No Pinterest developer approval

Skip the app registration and advanced scopes approval cycle. Our partner status covers you.

Pinterest-native metrics

Saves and closeups matter on Pinterest. We surface them alongside clicks and spend.

Multi-platform ads

Run Pinterest alongside Meta, Google, LinkedIn, TikTok, and X from one dashboard.

REST API

Create, pause, edit, and delete campaigns. Pull analytics. Manage budgets.

Promote any organic Pin

Boost existing Pins without creating a duplicate creative - Zernio-scheduled Pins are one API call away from being promoted.

One key, 21 integrations

Same API key handles Pinterest organic posting + ads alongside 20 other social + ad integrations.

Code Examples

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"],
      "genders": ["female", "unknown"],
      "locations": ["US", "CA"],
      "interests": ["home_decor", "diy_projects"]
    }
  }'

Boost an Existing Pin

cURL

curl -X POST "https://zernio.com/api/v1/ads/boost" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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" }
  }'

View Full API Documentation →

See it in action

Promoted Pin campaigns and ad groups side by side.

Saves, closeups, and clicks in real time.

Access Pinterest Ads API with Zernio

Feature	Status
Promoted Pin campaigns (Campaign › Ad Group › Pin)	Yes
Boost existing organic Pins	Yes
Demographic + interest targeting	Yes
Real-time analytics (spend, saves, closeups, clicks)	Yes
Pinterest Conversions API	Roadmap
Catalog / Shopping ads	Roadmap

If a specific campaign type is blocking your integration, let us know.

Frequently Asked Questions

Does Pinterest have an API?: └Yes. Pinterest's v5 API covers Pins, Boards, Ads, Catalogs, and Conversions. Direct access requires developer registration and app approval for advanced scopes. Zernio wraps the Ads surface in REST.
Is the Pinterest API free?: └Pinterest's API itself is free - you only pay for ad spend served. Zernio's Ads add-on starts at $10/mo on the Build plan.
How do I get a Pinterest API key?: └You don't need one directly. Sign up for Zernio, connect your Pinterest Business account via OAuth, and use your Zernio API key for everything including Pinterest Ads operations.
Can I create Promoted Pin campaigns?: └Yes. Full Campaign → Ad Group → Pin hierarchy with objectives, budget, schedule, and targeting. Boost an existing organic Pin or provide a new pinId.
Are Catalog ads and Conversions API supported?: └Not yet. Pinterest Conversions API and Merchant-Center-backed Catalog ads are on our roadmap. Reach out if they're blocking you so we can prioritise.
Can I run Pinterest alongside other ad platforms?: └Yes. Single /v1/ads endpoint - platform parameter picks pinterestads. One API key, all ad platforms.

Related Features

Pinterest Ads API Reference

Endpoints and code examples

Meta Ads API

Facebook + Instagram campaigns

TikTok Ads API

Spark Ads and standalone campaigns

All Ad Platforms

Ads umbrella page

Run Pinterest Ads Without the Developer Wait

Requires the Ads add-on. REST API for Promoted Pins.

Enable Ads View API Reference