Find Pinterest ad targeting options
search_pinterest_ads_targetingIdentify valid Pinterest ad targeting IDs by type—INTEREST, GEO, LOCATION, AGE_BUCKET, KEYWORD and more—and drill into interest subtrees to ensure campaigns reach the intended audience.
Instructions
THE IDS AN AD GROUP’S targetingSpec NEEDS. create_pinterest_ads_campaign and create_pinterest_ads_ad_group accept interests, locales, locations, age buckets and keywords — this is where those values come from, and guessing one is the worst option available: Pinterest ACCEPTS a well-formed but wrong interest id and the campaign then quietly targets the wrong people. Pass targetingType (INTEREST, GEO, LOCATION, LOCALE, AGE_BUCKET, GENDER, APPTYPE, KEYWORD, AUDIENCE_INCLUDE, AUDIENCE_EXCLUDE) and optionally query to narrow the list. INTERESTS ARE A TREE: pass interestId instead to drill into one and get its children, which is how you get from "Food" to something specific enough to target. Pinterest publishes no search parameter of its own, so query filters the full list HERE — the note says so, because a filter we applied is not a filter the vendor applied. Read-only, 0 credits, no new permission (it uses ads:read, already granted).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 1–500, default 100 | |
| query | No | narrow the list to options mentioning this text (filtered here, not by Pinterest) | |
| interestId | No | drill INTO one interest and return its child interests — how you walk the interest tree | |
| adAccountId | No | ||
| targetingType | No | which catalog to list — required unless you pass interestId |