Run a Pinterest Ads targeting report
Run live targeting analytics for an ad account, campaigns, ad groups, or ads, broken down by age, gender, location, interest, keyword, audience, placement. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date, end date and targeting types.
Inputs
- Start date
- First date of the reporting period, in YYYY-MM-DD formatRequired · startDate
- End date
- Last date of the reporting period, in YYYY-MM-DD format, on or after startDateRequired · endDate
- Targeting types
- Native targeting categories used to break down deliveryRequired · targetingTypes
- Ad account ID
- Owning advertising account IDOptional · adAccountId
- Level
- Entity or aggregation level for the requested report (AD_ACCOUNT, CAMPAIGN, AD_GROUP or AD)Optional · level
- Entity IDs
- Exact IDs of the entities to include in the selected reporting levelOptional · entityIds
- Columns
- Native Pinterest reporting column namesOptional · columns
- Granularity
- Time bucket used to aggregate reporting rows (TOTAL, DAY, HOUR, WEEK or MONTH)Optional · granularity
- Click window days
- Click-through attribution window, in daysOptional · clickWindowDays
- Engagement window days
- Engagement-through attribution window, in daysOptional · engagementWindowDays
- View window days
- View-through attribution window, in daysOptional · viewWindowDays
- Conversion report time
- Whether conversions are assigned to the ad action date or the conversion date (TIME_OF_AD_ACTION or TIME_OF_CONVERSION)Optional · conversionReportTime
- Attribution types
- Provider attribution categories included in the reportOptional · attributionTypes
- Reporting timezone
- Provider reporting timezone selector (PINTEREST_TIME_ZONE or AD_ACCOUNT_TIME_ZONE)Optional · reportingTimezone
- 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
Connect your agent to 2,400+ tools for free
Sign in with Google or GitHub. No card required.