Two ways to get Apple Search Ads data out.
Apple Search Ads is now called Apple Ads, and its reporting sits in the Apple Ads Platform API. The work is in the key handling, the short daily report windows and the move off the Campaign Management API, which Apple retires on January 26, 2027.
Build and run it yourself
- Have an account administrator invite an API user in Apple Ads. The API Account Read Only role can view reporting and data.
- Generate an elliptic curve key pair, upload the public key and sign a client secret with the
clientId,teamIdandkeyIdApple returns. The secret expires within 180 days. - Exchange the secret for an access token with scope
searchadsorg. Tokens last one hour. Name the ad account in theX-AP-Contextheader. - Call
POST /v1/reports/apps/campaigns/querywithDAILYgranularity. A daily request spans 90 days at most. - Pace requests from the
RateLimit-Remainingheader, and on a429wait the seconds given inRetry-After. - Map campaigns to your own markets. A campaign can target several countries, so group by
countryOrRegionwhen you need the split.
Then monitor it, sign a new client secret before the old one expires, and follow Apple's API versions.
Have Odins run it
- Access is set up with you at onboarding. Credentials go in through your Odins onboarding link, never by email.
- We sync every day, monitor the pipeline and maintain it as Apple changes its API.
- You get spend per campaign per day, in the same structure as every other channel.
- History from before the API's daily window can be imported from your own exports when you ask.
The same goes for every other source you use. One team runs all of them. See all connectors
What the Apple Search Ads API offers.
Reports are query endpoints in the Apple Ads Platform API: you post a time range, filters and an optional breakdown, and get rows back as JSON. Apple's own documentation is the reference.
Base URL https://api.ads.apple.com/v1
| Endpoint | What it returns | Good to know |
|---|---|---|
POST /reports/apps/campaigns/query |
Spend, impressions, taps and installs per App Store campaign, in total or per hour, day, week or month. | The campaignId filter is optional. |
POST /reports/apps/adgroups/query, /ads/query, /keywords/query, /searchterms/query |
Metrics per ad group, ad, keyword or search term. | These need a campaignId filter. Search term reports use the organization time zone only. |
POST /reports/business-brands/campaigns/query |
Performance data for campaigns on Apple Maps. | Separate request and response objects. |
GET /acls |
The ad accounts the token can reach, with the roles on each. | Each token is bound to one organization. |
Campaign report breakdowns
countryOrRegioncountryCodeadminArealocalitydeviceClassageRangegender
- Auth OAuth 2 client credentials
- Format JSON
- Quota Reported in RateLimit headers
- Daily reports 90-day span per request
Worth knowing about Apple Search Ads data.
Apple Search Ads is now Apple Ads.
Apple changed the name on April 14, 2025. App Store ads run on the Today tab, the Search tab, in search results and on product pages, and ads on Apple Maps have their own reports.
Daily history is short.
In the Campaign Management API a daily report starts at most 90 days back, weekly and monthly reports 24 months. The Platform API caps a daily request at 90 days.
Installs follow Apple's attribution windows.
Tap-through installs are counted within a 30-day window of the tap, view-through installs within one day of the ad view. Total installs combine the two.
Time zone and currency come from your Apple Ads account.
Reports default to the organization's time zone, with UTC as the other choice. Spend arrives in the ad account's currency and excluding VAT.
What you get back.
Two layers. The raw one mirrors Apple Search Ads. The structured one is the table every source lands in, organised by your own markets and product lines.
Structured layer
Per campaign, per day| In the structured table | For Apple Search Ads |
|---|---|
| Date | Daily |
| Company and market | Set by your routing rules on campaign names |
| Channel and media | Follows your media plan |
| Source campaign | Campaign |
| Spend | Spend, excluding VAT |
Raw layer
As Apple returns itDaily spend per campaign as Apple's campaign report returns it, in the ad account's currency.
Use it where you work.
In your warehouse
Raw and structured tables delivered to BigQuery, Snowflake, Redshift or Databricks. Some customers use Odins for this alone.
In Odins
Reporting across every channel, and a model that shows what search contributes and where more spend still pays.
Through your AI assistant
Connect Claude, ChatGPT or Copilot to Odins with MCP and ask for the numbers in plain language.
Questions.
Does Apple Search Ads have an API?
Yes. Apple Search Ads, now Apple Ads, has the Apple Ads Platform API, version 1.0, which returns reports per campaign, ad group, ad, keyword and search term. It replaces the Campaign Management API, which Apple sunsets on January 26, 2027.
How do I get Apple Search Ads data into BigQuery?
Access is set up with you at onboarding, through your Odins onboarding link. Odins syncs daily and delivers raw and structured tables to BigQuery, Snowflake, Redshift or Databricks.
Is Apple Search Ads the same as Apple Ads?
Yes. Apple renamed Apple Search Ads to Apple Ads on April 14, 2025, because its ad offerings had grown beyond search.
How far back does Apple Search Ads data go?
Apple documents 90 days back for daily reports and 24 months for weekly and monthly reports in the Campaign Management API. Older daily history can be imported into Odins from your own exports.
What happens when Apple retires the Campaign Management API?
Apple sunsets it on January 26, 2027, and points to the Apple Ads Platform API instead. A pipeline you built yourself has to move before then. Odins maintains its connector for you.
-1.png?width=1132&height=292&name=Asset%201@2x%20(12)-1.png)