Pinterest

Pinterest Ad API

The Ad API from Pinterest — 63 operation(s) for ad.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 85

GET /ad_accounts List ad accounts #
POST /ad_accounts Create ad account #
GET /ad_accounts/{ad_account_id} Get ad account #
GET /ad_accounts/{ad_account_id}/ad_groups List ad groups #
POST /ad_accounts/{ad_account_id}/ad_groups Create ad groups #
PATCH /ad_accounts/{ad_account_id}/ad_groups Update ad groups #
GET /ad_accounts/{ad_account_id}/ad_groups/analytics Get ad group analytics #
GET /ad_accounts/{ad_account_id}/ad_groups/targeting_analytics Get targeting analytics for ad groups #
POST /ad_accounts/{ad_account_id}/ad_groups/audience_sizing Get audience sizing #
GET /ad_accounts/{ad_account_id}/ad_groups/{ad_group_id} Get ad group #
POST /ad_accounts/{ad_account_id}/ad_previews Create ad preview with pin or image #
GET /ad_accounts/{ad_account_id}/ads List ads #
POST /ad_accounts/{ad_account_id}/ads Create ads #
PATCH /ad_accounts/{ad_account_id}/ads Update ads #
GET /ad_accounts/{ad_account_id}/ads/analytics Get ad analytics #
GET /ad_accounts/{ad_account_id}/ads_credit/discounts Get ads credit discounts #
POST /ad_accounts/{ad_account_id}/ads_credit/redeem Redeem ad credits #
GET /ad_accounts/{ad_account_id}/ads/targeting_analytics Get targeting analytics for ads #
GET /ad_accounts/{ad_account_id}/ads/{ad_id} Get ad #
GET /ad_accounts/{ad_account_id}/analytics Get ad account analytics #
GET /ad_accounts/{ad_account_id}/audience_insights Get audience insights #
GET /ad_accounts/{ad_account_id}/audiences List audiences #
POST /ad_accounts/{ad_account_id}/audiences Create audience #
GET /ad_accounts/{ad_account_id}/audiences/{audience_id} Get audience #
PATCH /ad_accounts/{ad_account_id}/audiences/{audience_id} Update audience #
POST /ad_accounts/{ad_account_id}/audiences/custom Create custom audience #
POST /ad_accounts/{ad_account_id}/bid_floor Get bid floors #
GET /ad_accounts/{ad_account_id}/billing_profiles Get billing profiles #
POST /ad_accounts/{ad_account_id}/bulk/download Get advertiser entities in bulk #
POST /ad_accounts/{ad_account_id}/bulk/upsert Create/update ad entities in bulk #
GET /ad_accounts/{ad_account_id}/bulk/{bulk_request_id} Download advertiser entities in bulk #
GET /ad_accounts/{ad_account_id}/campaigns List campaigns #
POST /ad_accounts/{ad_account_id}/campaigns Create campaigns #
PATCH /ad_accounts/{ad_account_id}/campaigns Update campaigns #
GET /ad_accounts/{ad_account_id}/campaigns/analytics Get campaign analytics #
GET /ad_accounts/{ad_account_id}/campaigns/targeting_analytics Get targeting analytics for campaigns #
GET /ad_accounts/{ad_account_id}/campaigns/{campaign_id} Get campaign #
GET /ad_accounts/{ad_account_id}/conversion_tags Get conversion tags #
POST /ad_accounts/{ad_account_id}/conversion_tags Create conversion tag #
GET /ad_accounts/{ad_account_id}/conversion_tags/ocpm_eligible Get Ocpm eligible conversion tags #
GET /ad_accounts/{ad_account_id}/conversion_tags/page_visit Get page visit conversion tags #
GET /ad_accounts/{ad_account_id}/conversion_tags/{conversion_tag_id} Get conversion tag #
POST /ad_accounts/{ad_account_id}/customer_lists Create customer lists #
GET /ad_accounts/{ad_account_id}/customer_lists Get customer lists #
GET /ad_accounts/{ad_account_id}/customer_lists/{customer_list_id} Get customer list #
PATCH /ad_accounts/{ad_account_id}/customer_lists/{customer_list_id} Update customer list #
POST /ad_accounts/{ad_account_id}/events Send conversions #
GET /ad_accounts/{ad_account_id}/insights/audiences Get audience insights scope and type #
GET /ad_accounts/{ad_account_id}/keywords Get keywords #
POST /ad_accounts/{ad_account_id}/keywords Create keywords #
PATCH /ad_accounts/{ad_account_id}/keywords Update keywords #
GET /ad_accounts/{ad_account_id}/keywords/metrics Get country's keyword metrics #
GET /ad_accounts/{ad_account_id}/lead_forms Get lead forms #
GET /ad_accounts/{ad_account_id}/lead_forms/{lead_form_id} Get lead form by id #
POST /ad_accounts/{ad_account_id}/lead_forms/{lead_form_id}/test Create lead form test data #
POST /ad_accounts/{ad_account_id}/leads/subscriptions Create lead ads subscription #
GET /ad_accounts/{ad_account_id}/leads/subscriptions Get lead ads subscriptions #
GET /ad_accounts/{ad_account_id}/leads/subscriptions/{subscription_id} Get lead ads subscription #
DELETE /ad_accounts/{ad_account_id}/leads/subscriptions/{subscription_id} Delete lead ads subscription #
GET /ad_accounts/{ad_account_id}/mmm_reports Get advertiser Marketing Mix Modeling (MMM) report #
POST /ad_accounts/{ad_account_id}/mmm_reports Create a request for a Marketing Mix Modeling (MMM) report #
GET /ad_accounts/{ad_account_id}/order_lines Get order lines #
GET /ad_accounts/{ad_account_id}/order_lines/{order_line_id} Get order line #
POST /ad_accounts/{ad_account_id}/product_group_promotions Create product group promotions #
PATCH /ad_accounts/{ad_account_id}/product_group_promotions Update product group promotions #
GET /ad_accounts/{ad_account_id}/product_group_promotions Get product group promotions #
GET /ad_accounts/{ad_account_id}/product_group_promotions/{product_group_promotion_id} Get a product group promotion by id #
GET /ad_accounts/{ad_account_id}/product_groups/analytics Get product group analytics #
GET /ad_accounts/{ad_account_id}/product_groups/catalogs Get catalog product groups #
GET /ad_accounts/{ad_account_id}/reports Get the account analytics report created by the async call #
POST /ad_accounts/{ad_account_id}/reports Create async request for an account analytics report #
DELETE /ad_accounts/{ad_account_id}/sandbox Delete ads data for ad account in API Sandbox #
GET /ad_accounts/{ad_account_id}/ssio/accounts Get Salesforce account details including bill-to information #
POST /ad_accounts/{ad_account_id}/ssio/insertion_orders Create insertion order through SSIO #
PATCH /ad_accounts/{ad_account_id}/ssio/insertion_orders Edit insertion order through SSIO #
GET /ad_accounts/{ad_account_id}/ssio/insertion_orders/status Get insertion order status by ad account id #
GET /ad_accounts/{ad_account_id}/ssio/insertion_orders/{pin_order_id}/status Get insertion order status by pin order id #
GET /ad_accounts/{ad_account_id}/ssio/order_lines Get Salesforce order lines by ad account id #
GET /ad_accounts/{ad_account_id}/targeting_analytics Get targeting analytics for an ad account #
GET /ad_accounts/{ad_account_id}/targeting_templates List targeting templates #
POST /ad_accounts/{ad_account_id}/targeting_templates Create targeting templates #
PATCH /ad_accounts/{ad_account_id}/targeting_templates Update targeting templates #
GET /ad_accounts/{ad_account_id}/templates List templates #
POST /ad_accounts/{ad_account_id}/templates/{template_id}/reports Create async request for an analytics report using a template #
GET /ad_accounts/{ad_account_id}/terms_of_service Get terms of service #

Documentation

📖
Documentation
https://developers.pinterest.com/docs/api/v5/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/openapi/pinterest-ad-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/openapi/pinterest-asyncapi.yml

Other Resources

🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/pinterest-ad-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pinterest-ad-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 5.13.0
  title: Pinterest Ad API
  description: This is the description of your API.
  contact:
    name: Pinterest, Inc.
    url: https://developers.pinterest.com/
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://developers.pinterest.com/terms/
servers:
- url: https://api.pinterest.com/v5
tags:


# --- truncated at 32 KB (440 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/openapi/pinterest-ad-api-openapi.yml