pinterest_run_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…

Run live targeting analytics for an ad account, campaigns, ad groups, or ads, broken down by age, gender, location, interest, keyword, audience, placement, device, or other Pinterest targeting types. For data older than the sync window, use pinterest_run_report with targetingTypes and executionMode=async.

Source: Pinterest Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/pinterest-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Optional	Owning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
`level`	string	Optional	Entity or aggregation level for the requested report. One of: `AD_ACCOUNT`, `CAMPAIGN`, `AD_GROUP`, `AD`. Default: `"AD_GROUP"`.
`entityIds`	array	Optional	Exact IDs of the entities to include in the selected reporting level.
`startDate`	string	Required	First date of the reporting period, in YYYY-MM-DD format.
`endDate`	string	Required	Last date of the reporting period, in YYYY-MM-DD format, on or after startDate.
`targetingTypes`	array	Required	Native targeting categories used to break down delivery.
`columns`	array	Optional	Native Pinterest reporting column names. Discover supported columns before selecting metrics. Default: `["SPEND_IN_DOLLAR","IMPRESSION_1","CLICKTHROUGH_1","OUTBOUND_CLICK_1","TOTAL_CHECKOUT","CHECKOUT_ROAS"]`.
`granularity`	string	Optional	Time bucket used to aggregate reporting rows. One of: `TOTAL`, `DAY`, `HOUR`, `WEEK`, `MONTH`. Default: `"DAY"`.
`clickWindowDays`	integer	Optional	Click-through attribution window, in days. Default: `30`.
`engagementWindowDays`	integer	Optional	Engagement-through attribution window, in days. Default: `30`.
`viewWindowDays`	integer	Optional	View-through attribution window, in days. Default: `1`.
`conversionReportTime`	string	Optional	Whether conversions are assigned to the ad action date or the conversion date. One of: `TIME_OF_AD_ACTION`, `TIME_OF_CONVERSION`. Default: `"TIME_OF_AD_ACTION"`.
`attributionTypes`	array	Optional	Provider attribution categories included in the report.
`reportingTimezone`	string	Optional	Provider reporting timezone selector. Keep it consistent when comparing periods. One of: `PINTEREST_TIME_ZONE`, `AD_ACCOUNT_TIME_ZONE`. Default: `"PINTEREST_TIME_ZONE"`.
`query`	object	Optional	Additional documented query parameters for the selected fixed GET endpoint.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_run_targeting_report",
    "args": {
      "startDate": "<string>",
      "endDate": "<string>",
      "targetingTypes": "<array>"
    }
  }
}