# Connect Apple Ads for keyword popularity

Connect your own Apple Ads account to see Apple’s official popularity for every iOS keyword in AppNorth. It’s free: no campaign, card or ad spend needed.

Source: https://www.appnorth.app/docs/apple-ads (2026-11-12)

## What you need

- An app published on the App Store.
- The Apple ID of your Apple developer account, to sign in to Apple Ads.
- Another Apple ID you can sign in with, to invite as the API user. It can use a second email address you own.

## Sign in to Apple Ads

1. Go to [ads.apple.com](https://ads.apple.com) and sign in with the Apple ID of your developer account.
2. If Apple asks you to create an account, choose **Apple Ads Advanced** and skip billing. Reading popularity needs no card or campaign.

## Invite an API user

1. In Apple Ads, open **Account Settings → User Management** and invite a user.
2. Enter the other Apple ID and choose the role **API Account Read Only**.
3. Open the invitation email and accept it, signing in with the Apple ID it was sent to.

## Create the API key

1. In AppNorth, open **Settings → Apple Ads** and click **Generate Key**. AppNorth creates the key pair on your Mac, and the private key never leaves it.
2. Click **Copy Public Key**.
3. Sign in to Apple Ads as the API user, open **Account Settings → API** and paste the public key.
4. Copy the **Client ID**, **Team ID** and **Key ID** that Apple shows into AppNorth.
5. Copy your **Account ID** into AppNorth. Apple shows it at the top right, under the account name.
6. Click **Check Connection**.

> **Check Connection** asks Apple for the popularity of one search term. An authenticated answer means the connection works, even when it has no rows.

## What it unlocks

- The **Popularity** column: Apple’s official popularity from 1 to 100 for the last completed week, for each iOS keyword in every country you track.
- **Research Keywords and Popularity…** in **Settings → Apple Ads**: check popularity and suggested phrases before you track them.
- Apple Ads phrases among the results of **Get Suggestions** in **Keywords**.
- Complete [audits](https://www.appnorth.app/docs/audit): a saved audit scores rankings and listing coverage only for keywords with official popularity.

## Fix connection errors

- “Apple Ads rejected the credentials. Check the Client ID, Team ID, and Key ID.”: an ID doesn’t match the public key you pasted. Copy all three again from **Account Settings → API**.
- “Apple Ads denied access. Check the Ad Account ID and API Read Only role.”: the Account ID is wrong, or the invited user doesn’t have an API role.
- “Apple Ads has temporarily limited requests.”: wait a few minutes. After an Apple Ads error, AppNorth also pauses popularity requests for 15 minutes.

## Questions

### Does Apple Ads cost anything?

No. AppNorth reads popularity with your own Apple Ads account. You don’t need a campaign, a card or any ad spend.

### Can I use the Apple ID I already use in Apple Ads?

Invite a second one. Each Apple Ads user has one role, and the API needs an API role, so a separate Apple ID keeps your own access as it is.

### Can AppNorth change my campaigns?

No. It uses the **API Account Read Only** role and only reads popularity and suggestions.

### Why do some keywords still show “—”?

Apple reports popularity only for App Store keywords and only when it has data. AppNorth then shows “—” instead of an estimate. Google Play keywords never have popularity.
