v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

ad_accounts

Create a request for a Marketing Mix Modeling (MMM) report

This creates an asynchronous mmm report based on the given request.
It returns a token that you can use to download the report when it is
ready. NOTE: An additional limit of 5 queries per minute per advertiser
applies to this endpoint while it's in beta release.
For the ADVERTISER_PAID_SPEND_IN_DOLLAR,
ADVERTISER_PAID_ECPC_IN_DOLLAR, and ADVERTISER_PAID_ECPM_IN_DOLLAR
columns: if you receive bonus media, this value still includes that spend, and it will
need to be removed manually with support from your Pinterest account team for a
fully netted value. Over time, we'll also subtract bonus media and other incentives as
data becomes available. Production and other non-media fees are excluded.

post/ad_accounts/{ad_account_id}/mmm_reports

Path parameters

ad_account_idstring required

Request body

advertiser_idsstring[]

Advertiser IDs for multi-advertiser report

columnsMMMReportingColumn[] required

Metric and entity columns

countriesTargetingAdvertiserCountry[]

A List of countries for filtering

custom_column_idsstring[]

List of custom column IDs

end_datestring required

Metric report end date (UTC). Format: YYYY-MM-DD

granularity'DAY' | 'WEEK' required

level'CAMPAIGN_TARGETING' | 'AD_GROUP_TARGETING' required

report_namestring required

Name of the Marketing Mix Modeling (MMM) report

start_datestring required

Metric report start date (UTC). Format: YYYY-MM-DD

targeting_typesMMMReportingTargetingType[] required

List of targeting types

Example request

{
  "columns": [
    "SPEND_IN_DOLLAR"
  ],
  "countries": [
    "US"
  ],
  "end_date": "2020-12-20",
  "start_date": "2020-12-20",
  "targeting_types": [
    "GENDER"
  ]
}

Response

The request has succeeded.

messagestring

Possible status for a bulk reporting job

sizenumber

statusstring

tokenstring

urlstring

Example response

{
  "report_status": "FINISHED",
  "status": "success"
}