API Reference
My API token 🔑

Paid Keywords by App

get
https://public-api.apptweak.com/api/public/store/apps/keywords/bids.json

Get an app's paid keywords, and the number of bids found for each.

Price

DatapointDescriptionCredits/request for 1 dayCredits/request per extra day
bidslist of objects, one per keyword on which an ad for the app was observed, with the day of each observation1000100
📘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 app IDs (max 5). How to find App IDs?

string
Defaults to us

Two-letter country code (us, gb, fr). Accepted values: GET /api/public/apptweak/countries with store=ios or store=android. 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 or store=android. Defaults to the country's default language.

string
enum
Defaults to iphone

Choose a device from iphone, ipad or android. Defaults to iphone.

Allowed:
date

Start date (YYYY-MM-DD). 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). The price is the same either way; it follows the date range, not this flag. 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.

Updated 2 days ago

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

Updated 2 days ago