Pinterest Ads pin analytics

Mode

Operation or analysis mode (PAID_PINS, ORGANIC_PINS, ORGANIC_PIN, USER_ACCOUNT, TOP_PINS or TOP_VIDEO_PINS)Required · mode

Start date

First date of the reporting period, in YYYY-MM-DD formatRequired · startDate

End date

Last date of the reporting period, in YYYY-MM-DD format, on or after startDateRequired · endDate

Metrics

Native or documented calculated metric names to requestRequired · metrics

Ad account ID

Owning advertising account IDOptional · adAccountId

Pin ID

Exact Pinterest pin IDOptional · pinId

Pin IDs

Exact Pinterest pin IDs to includeOptional · pinIds

Campaign ID

Exact campaign ID in the selected advertising accountOptional · campaignId

Granularity

Time bucket used to aggregate reporting rows (TOTAL, DAY, HOUR, WEEK or MONTH)Optional · granularity

Sort by

Required by Pinterest top-Pin endpoints; defaults to IMPRESSIONOptional · sortBy

Query

Additional documented query parameters for the selected fixed GET endpointOptional · query

Workspace ID

Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Price

$0.005 per call

Billing

The provider’s price, with no markup. Billed for measured usage.

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call

Copy

cURL command

Copy

TypeScript

Copy

Tool ID

Copy

• Pinterest Ads account entitiesPinterest Ads$0.005
• Pinterest Ads billing and ordersPinterest Ads$0.005
• Pinterest Ads catalog diagnosticsPinterest Ads$0.005
• Pinterest Ads catalog inventoryPinterest Ads$0.005
• Pinterest Ads conversion setupPinterest Ads$0.005
• Pinterest Ads delivery metricsPinterest Ads$0.005
• Pinterest Ads keyword intelligencePinterest Ads$0.005
• Pinterest Ads organic inventoryPinterest Ads$0.005
• Compare all 16