Get the paid keywords from an app and the share of voice of a paid keyword.
App Paid Keywords
Get the list of keywords for which an app has placed a bid. The App Paid Keywords endpoint returns the keywords for which an ad of an app was detected by AppTweak over the selected date range. The results can be either returned day-by-day or aggregated by keyword using the aggregated parameter.
In the example below, you can see the result and the format of the response for the app Disney+ in Belgium on Android.
App Paid Keywords for Disney Plus in the US on Android between 2022/09/01 and 2022/11/28 in with the aggregated view.
Only available in Search Ads countriesApple Search Ads is only available in some countries/regions, therefore the App Paid Keywords endpoint for iOS won't return results for non-ASA countries such as Brazil or Turkey for example. You can get the full list of countries on the following link.
Keyword Share of Voice
The Keyword Share of Voice (SOV) represents how often an ad shows in comparison to other ads on a keyword.
The keyword SOV of your app corresponds to:
#of occurrences of your app /# of occurrences all apps
In the example below, you can see the result and response format for the keyword "streaming" in Belgium, on Android between 2022/08/01 and 2022/08/15.
Keyword Share of Voice for the keyword "streaming" in Belgium for Android
FAQs
How do I fetch which keywords a competitor is bidding on in Apple Search Ads?
You can pull an app's paid keyword history with AppTweak's App Paid Keywords endpoint (GET /apps/keywords/bids.json), which returns every keyword AppTweak detected an ad for, for up to 5 apps at once, over a country, device, and date range you set. Each result lists the keyword and how many bids were detected; passing aggregated=true groups counts by keyword across the whole date range instead of returning day-by-day occurrences. This works for both iOS (Apple Search Ads) and Android.
What is app paid keyword intelligence and how does an API expose it?
App paid keyword intelligence is the set of keywords an app is actively bidding on in app store search ads, plus how visible its ads are relative to competitors. AppTweak's App Store API covers this through two endpoints: App Paid Keywords, which returns the keywords a given app has bid on, and Keywords Share of Voice, which returns which apps bid on a given keyword and how often each one's ad appeared. Together they let a developer move from "what is my competitor targeting" to "who dominates a specific term."
Is there an API for Apple Search Ads competitor data?
Yes — AppTweak's App Store API exposes Apple Search Ads intelligence through the App Paid Keywords and Keywords Share of Voice endpoints. Both are read-only, structured data endpoints, not a connection to a developer's own Apple Search Ads account: they report what AppTweak has observed in the market, not a specific advertiser's campaign console. App Paid Keywords takes an apps list and returns their detected keyword bids; Keywords Share of Voice takes a keywords list and returns which apps advertised on them.
How do I measure competitor ad spend or ad presence on app store keywords?
AppTweak's App Store API does not return advertiser bid amounts or spend, since Apple does not expose that data publicly. What it returns instead is ad presence: the Keywords Share of Voice endpoint (GET /keywords/apps/bids.json) reports each app's percent_sov on a keyword — the share of days in the date range that app's ad was detected, out of all apps that advertised on it — plus the specific date_occurrences. This is the closest proxy for competitive intensity on a keyword without exposing private bid data.
How do I calculate an app's share of voice for a specific app store keyword?
You can retrieve it directly from the Keywords Share of Voice endpoint (GET /keywords/apps/bids.json), which accepts up to 5 keywords and returns, per keyword, every app that bid on it with a percent_sov field. That field is the app's count of detected ad occurrences on the keyword divided by the total occurrences across all apps in the date range, expressed as a percentage. No separate calculation is needed — the endpoint already returns the ratio per app alongside the raw date_occurrences list used to compute it.
Why is share of voice data missing for a keyword I'm not already tracking?
Share of voice is only computed for keywords in AppTweak's own tracked-keyword database — a keyword that isn't already followed gets no search performed for it, so no data comes back. AppTweak runs one ad search per tracked keyword per day; keywords outside that set aren't queried automatically. For a keyword you need granular, on-demand ad visibility for (including ones not yet tracked), use the Keyword Live Search With Ads endpoint instead, which runs a live search at request time rather than relying on the daily tracked-keyword pass.