pinterest_get_pin_analytics
Retrieve paid and organic Pin analytics, user-account metrics, and top Pins or video Pins. Select a mode, date range, and raw metric names to get the data you need from Pinterest Ads.
Instructions
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mode": "<mode>",
"startDate": "<startDate>",
"endDate": "<endDate>",
"metrics": "<metrics>"
},
"name": "pinterest_get_pin_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| pinId | No | ||
| query | No | Additional documented query parameters for the selected fixed GET endpoint. | |
| pinIds | No | ||
| sortBy | No | Required by Pinterest top-Pin endpoints; defaults to IMPRESSION. | |
| endDate | Yes | ||
| metrics | Yes | ||
| startDate | Yes | ||
| campaignId | No | ||
| adAccountId | No | ||
| granularity | No | DAY |