Get analytics for several pins
pinterest_get_multi_pin_analyticsFetch analytics for up to 100 pins in one call instead of looping single-pin requests. Returns metrics for a date range within the last 90 days.
Instructions
Analytics for up to 100 pins in one call — far cheaper than looping pinterest_get_pin_analytics. Scope: pins:read.
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": {
"pin_ids": "<pin_ids>",
"start_date": "<start_date>",
"end_date": "<end_date>"
},
"name": "pinterest_get_multi_pin_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pin_ids | Yes | Up to 100 pin ids to fetch together. | |
| end_date | Yes | End of the window, inclusive. Date as YYYY-MM-DD. Must be within the last 90 days and no later than today. | |
| app_types | No | Restrict to a surface. Defaults to ALL. | |
| start_date | Yes | Start of the window, inclusive. Date as YYYY-MM-DD. Must be within the last 90 days and no later than today. | |
| metric_types | No | Metrics to return. Common values: ENGAGEMENT, IMPRESSION, PIN_CLICK, OUTBOUND_CLICK, SAVE, SAVE_RATE, TOTAL_AUDIENCE, ENGAGED_AUDIENCE, PROFILE_VISIT, USER_FOLLOW. Omit for all available. | |
| ad_account_id | No | Act on behalf of this ad account. Required only for business accounts operating on a shared asset. |