Query a report; larger requests return an asynchronous extraction

post/v1/reports/query

Request

  • Base URL: https://api.getmcpads.com
  • URL: https://api.getmcpads.com/v1/reports/query
  • Auth: HTTP bearer

Request body

sourcestring required
account_idsstring[] required
level'account' | 'campaign' | 'ad_group' | 'ad'
dimensionsstring[] required

Include date for daily rows; omit it for native totals over date_range, grouped by the selected dimensions. Filters apply to these report rows.

metricsstring[] required
resourcestring

Google Ads resource from the source catalog.

report_typestring

Microsoft, Amazon, Apple or Pinterest report type from catalog.query_options.

attribution_days'1' | '7' | '14' | '30'

Amazon attribution window.

placement'ALL_ON_TWITTER' | 'PUBLISHER_NETWORK'
entity_idsstring[]

Optional X entity IDs or Apple campaign parent IDs.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.