Use the Apple Ads Platform API

Create campaigns, ad groups, keywords, and more with the Apple Ads Platform API

The Apple Ads Platform API is designed to let developers, agencies, and third-party platforms manage campaigns and pull reports programmatically. It includes client libraries in multiple languages to help you integrate quickly. Use them to programmatically manage campaigns, ad groups, and keywords on the App Store, along with ads on Apple Maps.

Access the API documentation and see complete details

To implement the Apple Ads Platform API effectively, you’ll need to understand the technical requirements and plan ahead to ensure you have the resources needed to develop and maintain the application.

Access the Apple Ads Platform API

Apple Ads uses OAuth 2 to authenticate API requests. To access the Apple Ads Platform API within your own organization, you’ll need to create or designate an API user:

  1. Have an Account Admin sign in to your Apple Ads account.
  2. Go to the User Management tab within Account Settings.
  3. Edit or invite a new user and assign them one of the following roles: API Account Manager, API Account Read Only, or Limited Access API Read & Write or API Read Only.
  4. After your API user is set up, have them sign in to your Apple Ads account and go to the API tab within Account Settings.
  5. On the API page, they can create a client by following the steps outlined in the API documentation. For additional details on making calls against the API, refer to the documentation.

Note that if a user’s role changes from an API user to a non-API user, their API access will be revoked. In addition, API access for users associated with the deleted user will also be revoked.

Grant Apple Ads Platform API access to a third-party service provider

If you work with a campaign management partner or mobile measurement provider, your Apple Ads Account Admin or Campaign Group Manager can grant them access to your Apple Ads account through the use of a secure Apple sign in.

Here’s how to get started:

  1. If your service provider has secure Apple sign in set up, go to the Authorizations section within their platform and click the Sign in with Apple button.
  2. Sign in to Apple Ads as an Apple Ads Account Admin or Campaign Group Manager.
  3. Choose the Apple Ads account that you’d like the service provider to be able to access.
  4. Select the type of access you’d like to provide.

Review or revoke Apple Ads Platform API service provider access

To review third-party API access, go to the API tab within Account Settings. Third-party approvals may be revoked at any time by selecting from the list of authorized service providers and choosing Revoke Access from the Actions menu.

Request a third-party account

If you’re a third-party service provider developing marketing solutions on the Apple Ads Platform API for ads on the App Store or Apple Maps, please contact ads-registration@group.apple.com for more information on registering a third-party OAuth 2 application.