Pinterest Ads API
Pinterest Ads API enables agents to create and manage Pinterest advertising campaigns, ad groups, and promoted pins, retrieve analytics and conversion reporting, manage product catalogs, and build audiences for performance and shopping campaigns.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
OAuth 2.0 with access and refresh token rotation. Granular scopes allow separating read and write access for ads and catalogs. GDPR-compliant data handling documentation available for EU advertisers. Domain verification required for website traffic campaigns.
⚡ Reliability
Best When
Best when your business is in retail, fashion, home, or lifestyle verticals and needs agents to automate Pinterest Shopping campaigns and catalog-driven ad creation at scale.
Avoid When
Avoid when Pinterest is not a primary acquisition channel or when the business category does not align with Pinterest's predominantly discovery-oriented, visual shopping audience.
Use Cases
- • Create seasonal ad campaigns with targeting and budget parameters for e-commerce product promotions
- • Sync a product catalog from an e-commerce platform to Pinterest to keep Shopping ads current with inventory changes
- • Pull campaign performance metrics (spend, clicks, saves, conversions) into a unified marketing analytics pipeline
- • Pause campaigns and adjust bids automatically based on ROAS performance rules evaluated on a nightly schedule
- • Create custom audiences from customer email lists for retargeting users who have previously engaged with Pins
Not For
- • Organic pin management and board curation for brand presence (Pinterest Creator tools cover this use case)
- • B2B advertisers with non-visual products that do not fit Pinterest's predominantly retail and lifestyle audience
- • Small advertisers who cannot meet the spend thresholds required for API partner status
Interface
Authentication
Uses OAuth 2.0 authorization code flow with refresh tokens. Access requires a Pinterest developer app and approval for ads_read and ads_write scopes. Business accounts must authorize the app. Scopes include ads_read, ads_write, catalogs_read, catalogs_write, and pins_read. App review is required for production access to ad account scopes.
Pricing
Pinterest API access is free but requires app registration and scope review. Catalog features are available on business accounts. Conversion tag setup is required for conversion-objective campaigns.
Agent Metadata
Known Gotchas
- ⚠ Pinterest API uses a versioned URL structure (v5) — older client code targeting v3 or v4 endpoints will receive deprecation errors; always specify the version in the base URL
- ⚠ Campaign status transitions follow a strict state machine — for example, you cannot set an archived campaign back to active; agents must query current status before attempting state changes
- ⚠ Product catalog feeds are asynchronous — submitting a catalog update returns a job ID and completion must be polled; agents that assume synchronous catalog updates will see stale data
- ⚠ Conversion tracking requires a Pinterest Tag to be installed on the advertiser's website; conversion-objective campaign creation will fail silently or return low-quality data if the tag is not firing
- ⚠ Audience creation from customer lists has a minimum size threshold (typically 100 matched users); lists below this threshold may be created successfully but will not be usable for targeting
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Pinterest Ads API.
Scores are editorial opinions as of 2026-03-06.