{"abstract":[{"text":"Retrieve performance data for campaigns, ad groups, ads, keywords, and search terms.","type":"text"}],"hierarchy":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API"]]},"identifier":{"interfaceLanguage":"data","url":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/reports"},"kind":"article","legalNotices":{"copyright":"Copyright &copy; 2026 Apple Inc. All rights reserved.","privacyPolicy":"https:\/\/www.apple.com\/privacy\/privacy-policy","termsOfUse":"https:\/\/www.apple.com\/legal\/internet-services\/terms\/site.html"},"metadata":{"availableLanguages":["de-DE","en-US","es-419","fr-FR","it-IT","ja-JP","ko-KR","pt-BR","zh-CN"],"modules":[{"name":"Apple Ads Platform API"}],"role":"article","roleHeading":"Article","title":"Managing Reports"},"primaryContentSections":[{"content":[{"anchor":"Overview","level":2,"text":"Overview","type":"heading"},{"inlineContent":[{"text":"All report endpoints follow a shared ","type":"text"},{"code":"POST \/query","type":"codeVoice"},{"text":" pattern. You parameterize each request with ","type":"text"},{"code":"promotedObjectType","type":"codeVoice"},{"text":": either ","type":"text"},{"code":"apps","type":"codeVoice"},{"text":" for App Store app campaigns or ","type":"text"},{"code":"business-brands","type":"codeVoice"},{"text":" for Apple Maps campaigns. The request body, response objects, available groupBy dimensions, and supported options differ between the two promoted object types.","type":"text"}],"type":"paragraph"},{"anchor":"Choose-a-Reporting-Endpoint","level":2,"text":"Choose a Reporting Endpoint","type":"heading"},{"inlineContent":[{"text":"Query one of the following endpoints based on your promoted object type and the entity level you want to report on:","type":"text"}],"type":"paragraph"},{"header":"row","rows":[[[{"inlineContent":[{"text":"Method","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Path","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Description","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/apps\/campaigns\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-campaign-reports","isActive":true,"type":"reference"},{"text":" retrieves App Store campaign performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/apps\/adgroups\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-ad-group-reports","isActive":true,"type":"reference"},{"text":" retrieves App Store ad group performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/apps\/ads\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-ad-reports","isActive":true,"type":"reference"},{"text":" retrieves App Store ad performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/apps\/keywords\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-keyword-reports","isActive":true,"type":"reference"},{"text":" retrieves App Store keyword performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/apps\/searchterms\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-search-term-reports","isActive":true,"type":"reference"},{"text":" retrieves App Store search term performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/business-brands\/campaigns\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-campaign-reports","isActive":true,"type":"reference"},{"text":" retrieves Apple Maps campaign performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/business-brands\/adgroups\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-ad-group-reports","isActive":true,"type":"reference"},{"text":" retrieves Apple Maps ad group performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/business-brands\/ads\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-ad-reports","isActive":true,"type":"reference"},{"text":" retrieves Apple Maps ad performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/business-brands\/keywords\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-keyword-reports","isActive":true,"type":"reference"},{"text":" retrieves Apple Maps keyword performance data.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"POST","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"\/v1\/reports\/business-brands\/searchterms\/query","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-search-term-reports","isActive":true,"type":"reference"},{"text":" retrieves Apple Maps search term performance data.","type":"text"}],"type":"paragraph"}]]],"type":"table"},{"anchor":"Build-the-Request","level":3,"text":"Build the Request","type":"heading"},{"inlineContent":[{"text":"Every report request uses either ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/AppsReportingRequest","isActive":true,"type":"reference"},{"text":" or ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/BrandsReportingRequest","isActive":true,"type":"reference"},{"text":" as the request body. Both share the same top-level fields:","type":"text"}],"type":"paragraph"},{"items":[{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"timeRange","type":"codeVoice"},{"text":" field defines the reporting window via ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/TimeRange","isActive":true,"type":"reference"},{"text":": ","type":"text"},{"code":"start","type":"codeVoice"},{"text":" date, ","type":"text"},{"code":"end","type":"codeVoice"},{"text":" date, ","type":"text"},{"code":"timeZone","type":"codeVoice"},{"text":" (","type":"text"},{"code":"UTC","type":"codeVoice"},{"text":" or ","type":"text"},{"code":"ORTZ","type":"codeVoice"},{"text":"), and optional ","type":"text"},{"code":"granularity","type":"codeVoice"},{"text":" (","type":"text"},{"code":"HOURLY","type":"codeVoice"},{"text":", ","type":"text"},{"code":"DAILY","type":"codeVoice"},{"text":", ","type":"text"},{"code":"WEEKLY","type":"codeVoice"},{"text":", ","type":"text"},{"code":"MONTHLY","type":"codeVoice"},{"text":").","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"filters","type":"codeVoice"},{"text":" field is an array of ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Filter","isActive":true,"type":"reference"},{"text":" conditions that narrow results by field, operator, and value.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"sorting","type":"codeVoice"},{"text":" field is an array of ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Sorting","isActive":true,"type":"reference"},{"text":" objects that order rows by field and direction.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"pagination","type":"codeVoice"},{"text":" field uses ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/RequestPagination","isActive":true,"type":"reference"},{"text":", with ","type":"text"},{"code":"offset","type":"codeVoice"},{"text":" and ","type":"text"},{"code":"pageSize","type":"codeVoice"},{"text":" (maximum 5000, default 100).","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"fields","type":"codeVoice"},{"text":" field is an optional list of field names to return. Omit it to receive all fields.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":" field is an optional dimensional breakdown. Supported values differ between Apps and Brands, and additional restrictions apply at the keyword and search term entity levels. When you omit ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":", the response returns one aggregate row per entity with no dimensional breakdown. We recommend providing at least one ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":" value to get meaningful segmented data in most reporting use cases.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"options","type":"codeVoice"},{"text":" field sets row inclusion flags via ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/AppsOptions","isActive":true,"type":"reference"},{"text":" or ","type":"text"},{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/BrandsOptions","isActive":true,"type":"reference"},{"text":".","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Read-the-Response","level":3,"text":"Read the Response","type":"heading"},{"inlineContent":[{"text":"All report responses share the same envelope: a ","type":"text"},{"code":"result","type":"codeVoice"},{"text":" object containing a ","type":"text"},{"code":"rows","type":"codeVoice"},{"text":" array of report rows and a ","type":"text"},{"code":"summary.grandTotal","type":"codeVoice"},{"text":" object, plus a ","type":"text"},{"code":"pagination","type":"codeVoice"},{"text":" object and an ","type":"text"},{"code":"error","type":"codeVoice"},{"text":" field. Each row contains:","type":"text"}],"type":"paragraph"},{"items":[{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"totalMetrics","type":"codeVoice"},{"text":" field holds aggregate metrics for the row over the full time range.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"granularMetrics","type":"codeVoice"},{"text":" field breaks out metrics by the requested ","type":"text"},{"code":"granularity","type":"codeVoice"},{"text":" period, and it appears only when you specify ","type":"text"},{"code":"granularity","type":"codeVoice"},{"text":" in the request.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"metadata","type":"codeVoice"},{"text":" field holds entity attributes (campaign name, status, targeting, and so on) plus any ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":" dimension values applied to the row.","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"inlineContent":[{"text":"When you include ","type":"text"},{"code":"GRAND_TOTAL","type":"codeVoice"},{"text":" in ","type":"text"},{"code":"options.includeRows","type":"codeVoice"},{"text":", the response also includes a summary row with totals across all result rows.","type":"text"}],"type":"paragraph"},{"anchor":"Apply-Granularity-Constraints","level":3,"text":"Apply Granularity Constraints","type":"heading"},{"inlineContent":[{"text":"Granularity is an optional time-series breakdown that applies to ","type":"text"},{"code":"granularMetrics","type":"codeVoice"},{"text":". The following constraints apply to all entities and both promoted object types unless noted:","type":"text"}],"type":"paragraph"},{"header":"row","rows":[[[{"inlineContent":[{"text":"Granularity","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Constraint","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"HOURLY","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Date range must span 7 days or less, and ","type":"text"},{"code":"start","type":"codeVoice"},{"text":" must fall within the last 365 days. Ad-level and search term-level reports don’t support it.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"DAILY","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Date range must span 90 days or less.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"WEEKLY","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Date range must span at least 14 days.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"MONTHLY","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Date range must span at least 90 days.","type":"text"}],"type":"paragraph"}]]],"type":"table"},{"inlineContent":[{"text":"To request a single day of data, omit ","type":"text"},{"code":"granularity","type":"codeVoice"},{"text":" entirely. For a single-day request, the response returns results in ","type":"text"},{"code":"totalMetrics","type":"codeVoice"},{"text":" only, since there’s no ","type":"text"},{"code":"granularMetrics","type":"codeVoice"},{"text":" breakdown to compute.","type":"text"}],"type":"paragraph"},{"anchor":"Compare-Apps-and-Brands-Reporting","level":3,"text":"Compare Apps and Brands Reporting","type":"heading"},{"inlineContent":[{"text":"Apps and Brands campaigns measure different coverage: app installs and engagement versus brand visibility and map interactions. Their reporting reflects this distinction. The two promoted object types use separate request and response objects and differ in the following ways:","type":"text"}],"type":"paragraph"},{"header":"row","rows":[[[{"inlineContent":[{"text":"Feature","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Apps (","type":"text"},{"code":"apps","type":"codeVoice"},{"text":")","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Brands (","type":"text"},{"code":"business-brands","type":"codeVoice"},{"text":")","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Request object","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/AppsReportingRequest","isActive":true,"type":"reference"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/BrandsReportingRequest","isActive":true,"type":"reference"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Campaign\/ad-group ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":" dimensions","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"code":"deviceClass","type":"codeVoice"},{"text":", ","type":"text"},{"code":"ageRange","type":"codeVoice"},{"text":", ","type":"text"},{"code":"gender","type":"codeVoice"},{"text":", ","type":"text"},{"code":"countryCode","type":"codeVoice"},{"text":", ","type":"text"},{"code":"adminArea","type":"codeVoice"},{"text":", ","type":"text"},{"code":"locality","type":"codeVoice"},{"text":", ","type":"text"},{"code":"countryOrRegion","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"deviceClass","type":"codeVoice"},{"text":", ","type":"text"},{"code":"locationId","type":"codeVoice"},{"text":", ","type":"text"},{"code":"supplyPlacement","type":"codeVoice"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Keyword ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":" dimensions","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"code":"deviceClass","type":"codeVoice"},{"text":", ","type":"text"},{"code":"countryOrRegion","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"deviceClass","type":"codeVoice"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Search term ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":" dimensions","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"code":"deviceClass","type":"codeVoice"},{"text":", ","type":"text"},{"code":"countryOrRegion","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"deviceClass","type":"codeVoice"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Ad ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":" dimensions","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"code":"countryOrRegion","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"code":"deviceClass","type":"codeVoice"},{"text":", ","type":"text"},{"code":"locationId","type":"codeVoice"},{"text":", ","type":"text"},{"code":"supplyPlacement","type":"codeVoice"}],"type":"paragraph"}]],[[{"inlineContent":[{"code":"EMPTY_METRICS","type":"codeVoice"},{"text":" option","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Supported","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Not supported","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Creative metadata","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/AppsReportingCreative","isActive":true,"type":"reference"},{"text":": includes ","type":"text"},{"code":"creativeSpec","type":"codeVoice"},{"text":" and ","type":"text"},{"code":"destination","type":"codeVoice"}],"type":"paragraph"}],[{"inlineContent":[{"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/BrandsReportingCreative","isActive":true,"type":"reference"},{"text":": includes ","type":"text"},{"code":"id","type":"codeVoice"},{"text":", ","type":"text"},{"code":"creativeType","type":"codeVoice"},{"text":", and ","type":"text"},{"code":"systemStatus","type":"codeVoice"},{"text":" only","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Location-level report","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Not available","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Not available","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"Search term timezone","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"code":"ORTZ","type":"codeVoice"},{"text":" only","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"code":"ORTZ","type":"codeVoice"},{"text":" only","type":"text"}],"type":"paragraph"}]]],"type":"table"},{"anchor":"Include-Additional-Rows","level":3,"text":"Include Additional Rows","type":"heading"},{"inlineContent":[{"text":"The ","type":"text"},{"code":"options.includeRows","type":"codeVoice"},{"text":" field controls which additional rows appear in the response:","type":"text"}],"type":"paragraph"},{"items":[{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"GRAND_TOTAL","type":"codeVoice"},{"text":" value adds a summary row with aggregate totals across all result rows. Both Apps and Brands support it.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The ","type":"text"},{"code":"EMPTY_METRICS","type":"codeVoice"},{"text":" value includes rows for entities that have no metric activity during the requested period. Only Apps supports it, and you can’t combine it with ","type":"text"},{"code":"groupBy","type":"codeVoice"},{"text":".","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"seeAlsoSections":[{"anchor":"Related-Documentation","identifiers":["doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/insights-endpoints","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/recommendations-endpoints","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/suggestions-endpoints","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/change-history-endpoints"],"title":"Related Documentation"},{"anchor":"Reports","generated":true,"identifiers":["doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/apps-reports-endpoints","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/brands-reports-endpoints","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/apps-reports-objects","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/brands-reports-objects","doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/reports-shared-objects"],"title":"Reports"}],"variants":[{"paths":["\/documentation\/apple-ads-platform-api\/reports"],"traits":[{"interfaceLanguage":"data"}]}],"references":{"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API":{"abstract":[{"text":"Programmatically manage App Store and Apple Maps advertising campaigns through a single RESTful API.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Apple Ads Platform API"}],"role":"collection","title":"Apple Ads Platform API","type":"topic","url":"\/documentation\/apple-ads-platform-api"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/AppsOptions":{"abstract":[{"text":"Reporting options for apps promoted object type reports.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"AppsOptions"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/AppsOptions","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"AppsOptions"}],"role":"symbol","title":"AppsOptions","type":"topic","url":"\/documentation\/apple-ads-platform-api\/appsoptions"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/AppsReportingCreative":{"abstract":[{"text":"Creative metadata for apps ads.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"AppsReportingCreative"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/AppsReportingCreative","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"AppsReportingCreative"}],"role":"symbol","title":"AppsReportingCreative","type":"topic","url":"\/documentation\/apple-ads-platform-api\/appsreportingcreative"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/AppsReportingRequest":{"abstract":[{"text":"Request body for apps reporting queries.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"AppsReportingRequest"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/AppsReportingRequest","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"AppsReportingRequest"}],"role":"symbol","title":"AppsReportingRequest","type":"topic","url":"\/documentation\/apple-ads-platform-api\/appsreportingrequest"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/BrandsOptions":{"abstract":[{"text":"Reports options for brands promoted object campaigns.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"BrandsOptions"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/BrandsOptions","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"BrandsOptions"}],"role":"symbol","title":"BrandsOptions","type":"topic","url":"\/documentation\/apple-ads-platform-api\/brandsoptions"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/BrandsReportingCreative":{"abstract":[{"text":"Creative metadata for brands ads.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"BrandsReportingCreative"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/BrandsReportingCreative","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"BrandsReportingCreative"}],"role":"symbol","title":"BrandsReportingCreative","type":"topic","url":"\/documentation\/apple-ads-platform-api\/brandsreportingcreative"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/BrandsReportingRequest":{"abstract":[{"text":"Request body for brands reporting queries.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"BrandsReportingRequest"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/BrandsReportingRequest","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"BrandsReportingRequest"}],"role":"symbol","title":"BrandsReportingRequest","type":"topic","url":"\/documentation\/apple-ads-platform-api\/brandsreportingrequest"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Filter":{"abstract":[{"text":"Filter condition for reporting requests.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"Filter"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Filter","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"Filter"}],"role":"symbol","title":"Filter","type":"topic","url":"\/documentation\/apple-ads-platform-api\/filter"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-app-ad-group-reports":{"abstract":[{"text":"Retrieve performance metrics for ad groups.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-ad-group-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Ad Groups Report"}],"role":"symbol","title":"Ad Groups Report","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-app-ad-group-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-app-ad-reports":{"abstract":[{"text":"Retrieve performance metrics for ads.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-ad-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Ads Report"}],"role":"symbol","title":"Ads Report","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-app-ad-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-app-campaign-reports":{"abstract":[{"text":"Retrieve performance metrics for campaigns.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-campaign-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Campaigns Report"}],"role":"symbol","title":"Campaigns Report","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-app-campaign-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-app-keyword-reports":{"abstract":[{"text":"Retrieve performance metrics for keywords.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-keyword-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Keywords Report"}],"role":"symbol","title":"Keywords Report","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-app-keyword-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-app-search-term-reports":{"abstract":[{"text":"Retrieve performance metrics for the actual search terms that triggered keyword matches.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-app-search-term-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Search Terms Report"}],"role":"symbol","title":"Search Terms Report","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-app-search-term-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-ad-group-reports":{"abstract":[{"text":"Retrieve performance metrics for Apple Maps ad groups.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-ad-group-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Ad Groups Report (Brands)"}],"role":"symbol","title":"Ad Groups Report (Brands)","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-brand-ad-group-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-ad-reports":{"abstract":[{"text":"Retrieve performance metrics for Apple Maps ads.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-ad-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Ads Report (Brands)"}],"role":"symbol","title":"Ads Report (Brands)","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-brand-ad-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-campaign-reports":{"abstract":[{"text":"Retrieve performance metrics for Apple Maps campaigns.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-campaign-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Campaigns Report (Brands)"}],"role":"symbol","title":"Campaigns Report (Brands)","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-brand-campaign-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-keyword-reports":{"abstract":[{"text":"Retrieve performance metrics for Apple Maps keywords.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-keyword-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Keywords Report (Brands)"}],"role":"symbol","title":"Keywords Report (Brands)","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-brand-keyword-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-search-term-reports":{"abstract":[{"text":"Retrieve performance metrics for the actual search terms that triggered keyword matches in Apple Maps campaigns.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Get-brand-search-term-reports","kind":"symbol","navigatorTitle":[{"kind":"text","text":"Search Terms Report (Brands)"}],"role":"symbol","title":"Search Terms Report (Brands)","type":"topic","url":"\/documentation\/apple-ads-platform-api\/get-brand-search-term-reports"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/RequestPagination":{"abstract":[{"text":"Pagination settings specific to reporting requests.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"RequestPagination"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/RequestPagination","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"RequestPagination"}],"role":"symbol","title":"RequestPagination","type":"topic","url":"\/documentation\/apple-ads-platform-api\/requestpagination"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Sorting":{"abstract":[{"text":"Sort condition for reporting requests.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"Sorting"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/Sorting","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"Sorting"}],"role":"symbol","title":"Sorting","type":"topic","url":"\/documentation\/apple-ads-platform-api\/sorting"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/TimeRange":{"abstract":[{"text":"Date range, time zone, and granularity settings for reporting requests.","type":"text"}],"fragments":[{"kind":"text","text":"object "},{"kind":"identifier","text":"TimeRange"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/TimeRange","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"TimeRange"}],"role":"symbol","title":"TimeRange","type":"topic","url":"\/documentation\/apple-ads-platform-api\/timerange"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/apps-reports-endpoints":{"abstract":[{"text":"Retrieve App Store performance metrics for campaigns, ad groups, ads, keywords, and search terms.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/apps-reports-endpoints","kind":"article","role":"collectionGroup","title":"App Store Reports Endpoints","type":"topic","url":"\/documentation\/apple-ads-platform-api\/apps-reports-endpoints"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/apps-reports-objects":{"abstract":[{"text":"Request, response, and metadata objects for Apps report endpoints.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/apps-reports-objects","kind":"article","role":"collectionGroup","title":"Apps Data Objects","type":"topic","url":"\/documentation\/apple-ads-platform-api\/apps-reports-objects"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/brands-reports-endpoints":{"abstract":[{"text":"Retrieve performance data for Apple Maps campaigns, ad groups, ads, keywords, and search terms.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/brands-reports-endpoints","kind":"article","role":"collectionGroup","title":"Brands Reports Endpoints","type":"topic","url":"\/documentation\/apple-ads-platform-api\/brands-reports-endpoints"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/brands-reports-objects":{"abstract":[{"text":"Explore the request, response, and metadata objects that Brands report endpoints use.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/brands-reports-objects","kind":"article","role":"collectionGroup","title":"Brands Data Objects","type":"topic","url":"\/documentation\/apple-ads-platform-api\/brands-reports-objects"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/change-history-endpoints":{"abstract":[{"text":"Query audit summaries and retrieve change detail records for entities in an ad account.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/change-history-endpoints","kind":"article","role":"collectionGroup","title":"Change History Endpoints","type":"topic","url":"\/documentation\/apple-ads-platform-api\/change-history-endpoints"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/insights-endpoints":{"abstract":[{"text":"Query impression share and search term popularity data for your apps.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/insights-endpoints","kind":"article","role":"collectionGroup","title":"Insights Endpoints","type":"topic","url":"\/documentation\/apple-ads-platform-api\/insights-endpoints"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/recommendations-endpoints":{"abstract":[{"text":"Query budget and Target CPA recommendations, then apply or dismiss them to adjust campaign spend and bids.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/recommendations-endpoints","kind":"article","role":"collectionGroup","title":"Recommendations Endpoints","type":"topic","url":"\/documentation\/apple-ads-platform-api\/recommendations-endpoints"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/reports-shared-objects":{"abstract":[{"text":"Define time ranges, filters, sorting, and pagination for report requests, and read the shared metrics in responses.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/reports-shared-objects","kind":"article","role":"collectionGroup","title":"Shared Objects","type":"topic","url":"\/documentation\/apple-ads-platform-api\/reports-shared-objects"},"doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/suggestions-endpoints":{"abstract":[{"text":"Discover keyword, phrase, category, and Target CPA suggestions to expand keywords and size bids.","type":"text"}],"identifier":"doc:\/\/com.apple.apple-ads-platform-api\/documentation\/Apple-Ads-Platform-API\/suggestions-endpoints","kind":"article","role":"collectionGroup","title":"Suggestions Endpoints","type":"topic","url":"\/documentation\/apple-ads-platform-api\/suggestions-endpoints"},"doc://com.apple.documentation/documentation/technologies":{"abstract":[],"identifier":"doc:\/\/com.apple.documentation\/documentation\/technologies","kind":"technologies","role":"overview","title":"Technologies","type":"topic","url":"\/documentation\/technologies"}}}