Get account analytics
pinterest_get_user_analyticsRetrieve daily Pinterest account analytics for a date window up to 90 days, filtered by pin source, format, surface, content type, and selected metrics.
Instructions
Daily account-level analytics over a date window of up to 90 days. Scope: user_accounts:read and 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": {
"start_date": "<start_date>",
"end_date": "<end_date>"
},
"name": "pinterest_get_user_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Whether the metrics cover your pins, others' pins of your content, or both. | |
| 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. | |
| pin_format | No | Restrict to a pin format. | |
| 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. | |
| split_field | No | Break results down by a dimension, e.g. PIN_FORMAT, CONTENT_TYPE, SOURCE. | |
| content_type | No | Organic, paid, or both. | |
| 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. | |
| from_claimed_content | No | Filter by whether the content comes from a claimed domain. |