When optimizing your paid campaign strategy, tracking past data can help you make more informed decisions about your future advertising strategies. With this knowledge, you can ensure you are getting the most out of your advertising budget by following which terms are the best to bid on. With Sensor Tower’s, Search Ads feature in App Intelligence you can download a CSV of average Share of Voices (SOV). However, seeing the trending SOV date over the last few weeks, months, or quarters might be more attractive from an analysis standpoint. This can be done via the API.

    Seeing the raw data of the SOV over time provides insight into how well each term is performing and allows you to predict how well they might do in the future. This data allows you to make informed decisions on which terms you want to bid on moving forward. This document will walk you through how to pull this trending Search Ads SOV data through the API and other best practices for the Search Ads API.  


Working with the API

    Seeing the trending Share of Voice (SOV) can be easily pulled using our API. By knowing how well a Search Ad is doing in terms of SOV, you would be able to optimize your ASA campaign and ingest this type of data into your own internal dashboard to use for presentations to your team or managers.


  Follow the steps below to pull the trending SOV data for any dates 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. Specify the country you want to search for.

    • Note: Please look here to check if Sensor Tower supports Search Ads for your country.

  2. Create an array of dates you want to pull SOV for.

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

  3. Iterate through each term for each date using a nested loop.

    • Inject the date as both the “start_date” and “end_date” parameters to get the Share of Voice for that specific day and term as seen in the screenshot below.

  1. Pull important data from each JSON response body (such as SOV or traffic score). 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. A sample output can be seen below, where each date has a different SOV for each day and for each term:


    Run this script multiple times with ease to interact with the API for this trending raw data for SOV. The only parameters that need to change are the array of dates. Blend this raw data into your campaign metrics into a larger analysis for optimizing your ASA strategy. Furthermore, you can decide which terms would be worth bidding on based on weighing out the traffic score and how the raw SOV data looks for the date range you specified in the API pull. 


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