pinterest_run_conversion_product_report

Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku.

Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku. This is a restricted Pinterest feature: Standard API access alone does not guarantee availability for the client. It is separate from PRODUCT_ITEM spend reporting.

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.
`reportName`	string	Optional	Provider report name identifying the requested report recipe. Default: `"Pinterest Conversion Product Report"`.
`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.
`granularity`	string	Optional	Time bucket used to aggregate reporting rows. One of: `TOTAL`, `WEEK`, `MONTH`. Default: `"TOTAL"`.
`level`	string	Optional	Entity or aggregation level for the requested report. One of: `ADVERTISER`, `CAMPAIGN`, `AD_GROUP`. Default: `"CAMPAIGN"`.
`columns`	array	Optional	ConversionProductReportingColumn names. Defaults measure product quantity and value attributed to checkout, not checkout event count. Standard ads metrics such as TOTAL_CHECKOUT, SPEND_IN_DOLLAR and CHECKOUT_ROAS are not supported by this endpoint. Default: `["TOTAL_CHECKOUT_CONVERSION_PRODUCT_QUANTITY","TOTAL_CHECKOUT_CONVERSION_PRODUCT_VALUE"]`.
`conversionProductAttributionType`	string	Optional	Pinterest product-conversion attribution category. One of: `DEFAULT`, `BRAND_ATTRIBUTION`. Default: `"DEFAULT"`.
`conversionProductBreakdown`	string	Optional	Pinterest product-conversion grouping level. One of: `PRODUCT_BRAND`, `PRODUCT_CATEGORY`, `PRODUCT_BRAND_AND_CATEGORY`, `PRODUCT_SKU`, `PRODUCT_SKU_GROUP`. Default: `"PRODUCT_BRAND_AND_CATEGORY"`.
`campaignIds`	array	Optional	Restrict results to these campaign IDs.
`adGroupIds`	array	Optional	Restrict results to these ad group IDs.
`productSkuIds`	array	Optional	Restrict product-conversion reporting to these SKU IDs.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `500`.
`clickWindowDays`	integer	Optional	Click-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"`.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_run_conversion_product_report",
    "args": {
      "startDate": "<string>",
      "endDate": "<string>"
    }
  }
}