Pinterest Ads
Create Promoted Pin campaigns via Zernio API - No Pinterest developer approval required
Requires the Ads add-on. No Pinterest developer approval needed. Zernio handles the advanced scopes registration.
What's Supported
| 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 |
Create a Promoted Pin Campaign
const ad = await zernio.ads.createStandaloneAd({ body: {
accountId: "acc_pinterestads_123",
adAccountId: "549123456789",
name: "Spring home decor",
goal: "traffic",
budgetAmount: 30,
budgetType: "daily",
linkUrl: "https://example.com/spring-decor",
countries: ["US", "CA"],
ageMin: 25,
ageMax: 44,
}});ad = client.ads.create_standalone_ad(
account_id="acc_pinterestads_123",
ad_account_id="549123456789",
name="Spring home decor",
goal="traffic",
budget_amount=30,
budget_type="daily",
link_url="https://example.com/spring-decor",
countries=["US", "CA"],
age_min=25,
age_max=44,
)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" },
"creative": {
"pinId": "123456789012345678",
"landingPageUrl": "https://example.com/spring-decor"
},
"targeting": {
"age_groups": ["25-34", "35-44"],
"locations": ["US", "CA"],
"interests": ["home_decor", "diy_projects"]
}
}'Boost an Existing Pin
const ad = await zernio.ads.boostPost({ body: {
postId: "POST_ID",
accountId: "ACCOUNT_ID",
adAccountId: "549123456789",
name: "Boost decor Pin",
goal: "traffic",
budget: { amount: 30, type: "daily" },
schedule: { startDate: "2026-04-20", endDate: "2026-05-20" },
}});ad = client.ads.boost_post(
post_id="POST_ID",
account_id="ACCOUNT_ID",
ad_account_id="549123456789",
name="Boost decor Pin",
goal="traffic",
budget={"amount": 30, "type": "daily"},
schedule={"startDate": "2026-04-20", "endDate": "2026-05-20"},
)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 decor Pin",
"goal": "traffic",
"budget": { "amount": 30, "type": "daily" },
"schedule": { "startDate": "2026-04-20", "endDate": "2026-05-20" }
}'Pinterest-Native Metrics
Pinterest surfaces saves and closeups alongside standard click/spend metrics. These are included in /v1/ads/{id}/analytics.
Media Requirements
| Type | Format | Max Size | Notes |
|---|---|---|---|
| Standard Pin | JPEG, PNG | 20 MB | 1000x1500 (2:3) recommended |
| Video Pin | MP4, MOV, M4V | 2 GB | 4s-15min, 9:16 or 1:1 |