apple_ads_get_report

Read native Apple campaign, ad group, ad, keyword or search-term performance for explicit campaigns. One of 19 Apple Ads tools on the Get MCP Ads MCP gateway.

View as Markdown

Read native Apple campaign, ad group, ad, keyword or search-term performance for explicit campaigns. Preserves spend currency, attribution metrics, timezone, native grand totals and pagination. Never sum ratios or assume a page is the entire account. Monthly/weekly/daily historical reports are supported subject to Apple retention. Omit granularity for period totals. Campaign reports accept up to 20 campaigns; other levels require exactly one campaign per call.

Source: Apple Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/apple-ads/mcp

Parameters

Parameters
Name	Type	Required	Notes
`adAccountId`	string	Required	A selected Apple Ads ad account from list_accounts.
`campaignIds`	array	Required	Campaign IDs: up to 20 for campaigns; exactly one for adgroups, ads, keywords or searchterms.
`level`	string	Optional	Entity or aggregation level for the requested report. One of: `campaigns`, `adgroups`, `ads`, `keywords`, `searchterms`. Default: `"campaigns"`.
`startDate`	string	Required	First date of the reporting period, in YYYY-MM-DD format.
`endDate`	string	Required	Last date of the reporting period, in YYYY-MM-DD format, on or after startDate.
`timeZone`	string	Optional	Report timezone: account timezone (ORTZ) or UTC. One of: `ORTZ`, `UTC`. Default: `"ORTZ"`.
`granularity`	string	Optional	Time bucket used to aggregate reporting rows. One of: `HOURLY`, `DAILY`, `WEEKLY`, `MONTHLY`.
`fields`	array	Optional	Native metric names. Omit to retrieve all native metrics; Apple validates availability.
`groupBy`	array	Optional	Native demographic or geographic grouping dimensions.
`offset`	integer	Optional	Zero-based number of rows to skip before returning results. Default: `0`.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `100`.

Calling it

json · Through run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "apple_ads_get_report",
    "args": {
      "adAccountId": "<string>",
      "campaignIds": "<array>",
      "startDate": "<string>",
      "endDate": "<string>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.