Skip to content

Pinterest Ads audiences

Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.

Inputs

1 required
Mode
Operation or analysis modeRequired · mode
Ad account ID
Owning advertising account IDOptional · adAccountId
Audience ID
Exact ID of the audience to inspect or modifyOptional · audienceId
Customer list ID
Exact customer-list IDOptional · customerListId
Business ID
Exact business account ID used for the lookupOptional · businessId
Allow cross business read
Explicit opt-in required if the business cannot be linked to the selected ad accountOptional · allowCrossBusinessRead
Account type
Provider account category used to filter results (AD_ACCOUNT or BUSINESS_ACCOUNT)Optional · accountType
Ownership type
Filter audiences by provider ownership category (OWNED or RECEIVED)Optional · ownershipType
Exclude nca
Whether to exclude Pinterest new-customer-acquisition audiences from this lookupOptional · excludeNca
Page size
Maximum items requested per pageOptional · pageSize
Bookmark
Opaque Pinterest pagination bookmark returned by the previous responseOptional · bookmark
Query
Additional documented query parameters for the selected fixed GET endpointOptional · query
Workspace ID
Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Pricing

Price
$0.005 per call
Billing
The provider’s price, with no markup. Billed for measured usage.

Call

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call
cURL command
TypeScript
Tool ID

Alternatives

Pinterest Ads audiences & targeting

Connect your agent to 2,400+ tools for free

Sign in with Google or GitHub. No card required.