Apple Search Ads

Apple Search Ads is Apple's advertising platform for promoting apps on the App Store. Connect it to Coupler.io to automatically export your campaign performance, keyword data, demographic insights, and more to Google Sheets, Excel, BigQuery, Looker Studio, or AI destinations like Claude and ChatGPT.

Why connect Apple Search Ads to Coupler.io?

• Automated reporting — Schedule daily, weekly, or monthly exports without manual work

• Flexible report types — Pull campaign, ad group, keyword, and search term performance data

• Demographic insights — Break down performance by age, gender, location, and device

• Multi-account support — Combine data from multiple Apple Search Ads accounts in one data flow

• AI-powered analysis — Send reports to Claude or ChatGPT for instant insights

Prerequisites

• Active Apple Search Ads account with at least one ad account

• API Account Manager role (or equivalent) assigned to your Apple Search Ads user — account admin permissions alone are not enough

• Access to Apple Search Ads settings to verify API access

Do NOT use your main admin account if it doesn't have the API Account Manager role. Create a dedicated user with the correct API permissions, or ask your Apple Search Ads account owner to assign the role to your current account.

Quick start

Start by selecting your ad account and report type (e.g., Campaign performance), then set your date range. A single data flow can pull multiple report types — just set up each one and run them together.

How to connect

1

Log in to Coupler.io and create a new data flow. Choose Apple Search Ads as your source.

2

Sign in with Apple Search Ads. Click the OAuth button and you'll be redirected to Apple's login page. Sign in with your Apple Search Ads account (the one with API Account Manager role) and authorize Coupler.io to access your data.

3

Select your ad account(s). Choose which Apple Search Ads account(s) you want to pull data from. You can select multiple accounts to combine them in one data flow.

4

Choose a report type. Pick from Campaign performance, Ad group performance, Ad performance, Keyword performance, Search term performance, or demographic/geographic insights reports.

5

Set your date range. Use the date picker to select your start and end dates. You can also use macros (like {{30daysago}}) to make the range dynamic.

6

Choose how to split data. Select Daily, Weekly, Monthly, or Totals only to control how your metrics are aggregated in the report.

7

Select dimensions (if applicable). For demographic and geographic reports, choose dimensions like Age, Gender, Country, or Device class. You can combine dimensions (e.g., Country and Device class together).

8

Pick your destination. Choose where to send the data: Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like Claude or ChatGPT.

9

Run the data flow. Click Run to execute the data flow manually. Once it completes successfully, you can schedule it for recurring exports.

Available report types

Report Type	Best for	Includes
Campaign performance	High-level campaign metrics	Impressions, taps, conversions, spend, ROI
Ad group performance	Ad group-level analysis	Performance broken down by ad group
Ad performance	Individual ad creative analysis	Creative-level metrics and performance
Keyword performance	Keyword bid and performance data	Keyword metrics, CPC, conversion rate
Search term performance	Understanding user search behavior	Actual search terms users typed
Campaign/Ad group demo & geo	Audience insights	Demographics (age, gender), geography (country, locality, admin area), device class
Ad/Keyword performance by country	Geographic campaign analysis	Performance data split by country