Skip to content
Get MCP AdsGet MCP Ads, home

pinterest_run_catalog_report

Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. One of 56 Pinterest Ads tools on the Get MCP Ads MCP gateway.

Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. PRODUCT_ITEM history is limited to 92 days before today (UTC), with requests chunked into 31-day windows; older item performance cannot be retrieved by retrying. Use PRODUCT_GROUP for older catalog delivery totals, not individual SKU performance.

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
adAccountIdstringOptionalOwning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
breakdownstringOptionalNative reporting breakdown used to group results. One of: PRODUCT_GROUP, PRODUCT_ITEM. Default: "PRODUCT_GROUP".
startDatestringRequiredFirst date of the reporting period, in YYYY-MM-DD format.
endDatestringRequiredLast date of the reporting period, in YYYY-MM-DD format, on or after startDate.
columnsarrayOptionalNative Pinterest reporting column names. Discover supported columns before selecting metrics.
productGroupIdsarrayOptionalRestrict reporting to these product group IDs.
productItemIdsarrayOptionalRestrict reporting to these product item IDs.
limitintegerOptionalMaximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: 500.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_run_catalog_report",
    "args": {
      "startDate": "<string>",
      "endDate": "<string>"
    }
  }
}
Esc

Type to search