Validate a Pinterest Ads report

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

Ad account ID

Owning advertising account IDOptional · adAccountId

Level

Entity or aggregation level for the requested report (AD_ACCOUNT, CAMPAIGN, AD_GROUP, AD or PRODUCT_GROUP)Optional · level

Granularity

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

Columns

Native Pinterest reporting column namesOptional · columns

Execution mode

Choose the supported synchronous, asynchronous or automatic report execution strategy (auto, sync or async)Optional · executionMode

Entity IDs

Exact IDs of the entities to include in the selected reporting levelOptional · entityIds

Targeting types

Native targeting categories used to break down deliveryOptional · targetingTypes

Click window days

Click-through attribution window, in daysOptional · clickWindowDays

Engagement window days

Engagement-through attribution window, in daysOptional · engagementWindowDays

View window days

View-through attribution window, in daysOptional · viewWindowDays

Conversion report time

Whether conversions are assigned to the ad action date or the conversion date (TIME_OF_AD_ACTION or TIME_OF_CONVERSION)Optional · conversionReportTime

Attribution types

Provider attribution categories included in the reportOptional · attributionTypes

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