Keywords Share Of Voice

get

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

Get the applications whose ads were observed on a given keyword, their dates of occurrence, and their share of voice.

Price

Data	Credits	Per
Share of voice	5	request

Any date range up to 1 year costs the same.

Query Params

keywords

string

required

Comma-separated list of keywords (e.g. music,podcasts,songs). Max 5 keywords are allowed.

country

string

Defaults to us

Two-letter country code (us, gb, fr). For device=iphone or device=ipad, only Apple Ads countries and regions are supported. For device=android, accepted values: GET /api/public/apptweak/countries with store=android. Defaults to us.

language

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.

device

string

enum

Defaults to iphone

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

Allowed:

start_date

date

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

end_date

date

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

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.

200Successful response.