Run a Pinterest Ads report

Run a read-only Pinterest Ads report. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date and end date.

Inputs

2 required

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
Wait for report: False starts or polls an async report once and returns a resumable reportToken instead of waitingOptional · waitForReport
Report token: Resume a previously returned async reporting token for this ad account; never starts a second jobOptional · reportToken
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
Filters: Filters combined according to this tool's query schemaOptional · filters
Limit: Maximum number of returned items or rowsOptional · limit
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
Reporting timezone: Provider reporting timezone selector (PINTEREST_TIME_ZONE or AD_ACCOUNT_TIME_ZONE)Optional · reportingTimezone
Workspace ID: Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Pricing

Price: $0.005 per call
Billing: The provider’s price, with no markup. Billed for measured usage.

Call

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

MCP call
cURL command
TypeScript
Tool ID

Alternatives

Pinterest Ads reporting

Connect your agent to 2,400+ tools for free

Get $5 free credit Get $5 free credit