Use the Campaign Management API

Create campaigns, ad groups, and keywords with the Apple Search Ads Campaign Management API

The Campaign Management API for Apple Search Ads Advanced is designed to let developers, agencies, and third-party platforms manage campaigns and pull reports programmatically.

With the API, you can build software to manage your campaigns, ad groups, and keywords. It allows advertisers and third parties to more efficiently manage larger Apple Search Ads accounts and campaigns. Some use cases include:

  • Custom reports
  • Data ingestion to in-house business intelligence system
  • Cross-channel campaign management
  • Automated bid management
Access the API documentation and see complete details

To implement the Campaign Management 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 Campaign Management API

Apple Search Ads uses OAuth 2 to authenticate API requests. To access the Campaign Management 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 Search 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 Search 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 Campaign Management API access to a third-party service provider

If you work with a campaign management partner or mobile measurement provider, your Apple Search Ads account admin can grant them access to your Apple Search 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 Search Ads as an Apple Search Ads account admin.
  3. Choose the Apple Search 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 Campaign Management 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 Search Ads Campaign Management API, please contact ads-registration@group.apple.com for more information on registering a third-party OAuth 2 application.