Paid Keywords by App

Get an iOS app's paid keywords, and the number of bids found for each. Only iPhone and iPad in Apple Ads countries are supported, including historical date ranges.

Price

DataCreditsPer
Paid keywords5app


Any date range up to 1 year costs the same.
šŸ“˜Missing keywords?

Not seeing a keyword on which your app's ads run? One reason could be that AppTweak didn't fetch data for that keyword. You should make sure to follow the keyword for the selected device and country through our ASO tool to ensure its data is fetched daily.

Query Params
string
required

Comma-separated list of numeric App Store IDs (max 5). How to find App IDs?

string
Defaults to us

Two-letter country code (us, gb, fr). Only Apple Ads countries and regions are supported. Defaults to us.

string

AppTweak language code, not always ISO: US English is us, US Spanish sp. Accepted pairs: GET /api/public/apptweak/languages with store=ios. Defaults to the country's default language.

string
enum
Defaults to iphone

Choose iphone or ipad. Defaults to iphone.

Allowed:
date

Start date (YYYY-MM-DD). Send both dates or omit both. Maximum range: one full calendar year. Defaults to 30 days ago.

date

End date (YYYY-MM-DD). Defaults to yesterday.

boolean
Defaults to false

true: one row per keyword with the number of times an ad was observed over the range (count), highest count first. false: one row per keyword per day an ad was observed (date). Defaults to false.

Responses

401

Unauthorized. Unknown or missing API token.

403

Forbidden. Not enough credits to perform the request.

422

Validation error. Returned when a parameter is invalid, including Android devices or countries outside Apple Ads coverage (free), or with the code AppNotAvailableError when a requested app is not available in the country, language and device (costs 1 credit).

500

An internal service failed or returned an invalid response. The request is not charged.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json