pinterest_get_pin_analytics

Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins.

Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. Pass raw metric names supported by the selected Pinterest endpoint.

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.
`mode`	string	Required	Operation or analysis mode. Only the values declared in this schema are supported. One of: `PAID_PINS`, `ORGANIC_PINS`, `ORGANIC_PIN`, `USER_ACCOUNT`, `TOP_PINS`, `TOP_VIDEO_PINS`.
`pinId`	string	Optional	Exact Pinterest pin ID.
`pinIds`	array	Optional	Exact Pinterest pin IDs to include.
`campaignId`	string	Optional	Exact campaign ID in the selected advertising account.
`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.
`metrics`	array	Required	Native or documented calculated metric names to request. Check compatibility with the selected dimensions.
`granularity`	string	Optional	Time bucket used to aggregate reporting rows. One of: `TOTAL`, `DAY`, `HOUR`, `WEEK`, `MONTH`. Default: `"DAY"`.
`sortBy`	string	Optional	Required by Pinterest top-Pin endpoints; defaults to IMPRESSION.
`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_get_pin_analytics",
    "args": {
      "mode": "PAID_PINS",
      "startDate": "<string>",
      "endDate": "<string>",
      "metrics": "<array>"
    }
  }
}