Keeping track of the performance of your Apple Search Ads (ASA) can be a tedious process, especially if you are running ASA in multiple countries. In the Search Ads feature in Sensor Tower’s App Intelligence product, you can input a date range and any Search Ads country to see which keywords are performing well in terms of Share of Voice (SOV). Additionally, you can see the traffic score for each keyword to see how many people are actually entering that keyword as a query in the app store’s search bar. 

    If you click on the Download CSV button within the page, you can pull specific SOV data for all keywords for one country for an app, but what if you wanted to grab all the keywords for multiple countries? One workaround is to download a CSV for each country and combine all that data in one excel sheet. However, if you want this data on a frequent basis for weekly, monthly, or quarterly reports, pulling this data through the API may be more efficient. In this article, you will learn how to seamlessly pull Search Ads data through the API. 


Working through the API

Writing a script to pull data through the API would make your life easier if you want to pull ASA keywords for multiple countries. In the script, it would allow more freedom to batch country codes and date ranges. In this section, you will learn how to use the API to automate this process and grab the data you want at a much faster pace.


If you follow the steps below, you can pull the SOV data for multiple countries you specify:

  1. Use this endpoint(/v1/ios/search_ads/terms) to retrieve a list of terms that the given app has Search Ads for and put them into an array. Please click the “Try it Out!” button on the API documentation page to see the structure of the response body in JSON. Use the request URL and specify your parameters. The bolded parameters are required for each pull.


  1. In your script, create an array of country codes you want to pull Search Ads data for.

    • Note: Please look here to check if Sensor Tower supports Search Ads for your country. Also, this parameter needs a specific country code for each pull and does not allow you to batch country codes together.

  2. Indicate a “start_date” and “end_date” parameter. The SOV for each term will be the average SOV for the time range stated.

    • Note: Dates should be strings formatted as “YYYY-MM-DD.” 

  3. Iterate through each country for each call. Keep the “start_date” and “end_date” the same for each pull to show consistent SOV data across all countries.

  4. Pull the important data to you from each JSON response body  (such as SOV, traffic score, top competitors). The response body is an object with the key “terms” and the value of an array of objects containing information for each term. Please see the structure of each term object below:

  1. Write the data into a CSV for further data analysis. From this sheet, you can easily filter to compare the SOV for the same terms in each country or any other use case you can think of. A sample output can be seen below, where you can see the results from each country:

    After writing a script to automate this process, pull this data any time and spend more time analyzing data rather than pulling it. By seeing the average SOV for each term by country, you can determine which terms are performing better than others. In addition, with multiple reports, you can compare the average SOV of a term from one campaign to another. 


Note: The App Intelligence API is only available to Enterprise account. Please contact your Strategy Consultant or Customer Success Manager to see if your account has API access.


For more information or if you have any questions, please email support@sensortower.com