Skip to content
Get MCP AdsGet MCP Ads, home
Start free
View as Markdown

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.

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

NameTypeRequiredNotes
adAccountIdstringOptional
levelstringOptionalOne of: AD_ACCOUNT, CAMPAIGN, AD_GROUP, AD. Default: "AD_GROUP".
entityIdsarrayOptional
startDatestringRequired
endDatestringRequired
targetingTypesarrayRequired
columnsarrayOptionalDefault: ["SPEND_IN_DOLLAR","IMPRESSION_1","CLICKTHROUGH_1","OUTBOUND_CLICK_1","TOTAL_CHECKOUT","CHECKOUT_ROAS"].
granularitystringOptionalOne of: TOTAL, DAY, HOUR, WEEK, MONTH. Default: "DAY".
clickWindowDaysintegerOptionalDefault: 30.
engagementWindowDaysintegerOptionalDefault: 30.
viewWindowDaysintegerOptionalDefault: 1.
conversionReportTimestringOptionalOne of: TIME_OF_AD_ACTION, TIME_OF_CONVERSION. Default: "TIME_OF_AD_ACTION".
attributionTypesarrayOptional
reportingTimezonestringOptionalOne of: PINTEREST_TIME_ZONE, AD_ACCOUNT_TIME_ZONE. Default: "PINTEREST_TIME_ZONE".
queryobjectOptionalAdditional 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>"
    }
  }
}
Esc

Type to search