ASO App Keywords API for Google Play

---

ASO App Keywords API for Google Play. This API enables you to retrieve keywords for which this app is ranked.

Definition

Endpoint:

GET https://data.42matters.com/api/v2.0/android/aso/app_keywords.json

Hits per request:

20

Rate limit:

3 QPS

Required plan:

Tiny or above.

Parameters

Name	Required	Description	Available Values	Default
access_token	required	Your access token for using this API. You can get it for FREE by signing up .
p	required	The package name identifying an Android application.	Any publicly available Android app package name
country	optional	Return country-specific apps	ID of Supported Countries	US
lang	optional	Return language-specific apps	ID of Supported Languages	en
rank_min	optional	Minimum value of rank.	Long. Minimum 1.
rank_max	optional	Maximum value of rank.	Long. Maximum 100.
difficulty_min	optional	Minimum value of difficulty.	Long - Minimum 0.
difficulty_max	optional	Maximum value of difficulty.	Long. Maximum 100.
traffic_min	optional	Minimum value of traffic.	Long. Minimum 0.
traffic_max	optional	Maximum value of traffic.	Long. Maximum 100.
starts_with	optional	Return keywords that start with this string.	String
ends_with	optional	Return keywords that end with this string.	String
contains	optional	Return keywords that contain this string.	String
exclude_starts_with	optional	Exclude keywords that start with this string.	String
exclude_ends_with	optional	Exclude keywords that end with this string.	String
exclude_contains	optional	Exclude keywords that contain this string.	String
limit	optional	How many keywords to return	Long. Maximum 50.	10
page	optional	Page based on the limit parameter, used for pagination.	1 - max_pages. There is a limit of 10000 results that can be iterated.
sort	optional	Sort returned keywords by a sorting criteria.	Value Description relevancy Sort by relevancy difficulty Sort by estimation of how much competitive is the usage market targeting of a specific keyword traffic Sort by estimation of how frequently a certain keyword is being researched rank Sort by keyword rank keyword Sort by keyword alphabetically	relevancy
sort_order	optional	Sort ordering.	desc or asc	desc
callback	optional	If supplied, the response will use the JSONP format with a callback of the given name.

Responses

Status Code	Indication	Content-Type	Body
200	Everything is OK	application/json	Attribute Type Description package_name String The app package name (unique identifier) country String Country search for lang String Language search for number_results Long Number of results found num_pages Long Maximum number of pages it's possible to iterate has_next Boolean Flag indicating if there is a next page available limit Long Number of results per request page Long Current page number results Array of Objects Each object contains: keyword - string difficulty - Difficulty is a metric used in ASO to estimate how difficult it would be to rank on the search results for a given keyword: Range is 0 (very easy) -100 (very difficult). traffic - Estimation of how frequently a certain keyword is being researched . Range is 0 (very low traffic) -100 (very high traffic). rank - The order (rank) in which this app appears in the results when searching with this keyword (long)
404	The keywords are not found	application/json	Error object
402	Your request exceeds what's allowed by your current subscription plan	application/json	Error object
403	Your access token is not valid	application/json	Error object
429	Your request rate is over the limit	application/json	Error object

Example Request

ASO App Keywords for package name:

https://data.42matters.com/api/v2.0/android/aso/app_keywords.json?p=com.facebook.katana&country=US&limit=10&access_token=YOUR_ACCESS_TOKEN

---

This request can also be imported into Postman. Check out our Postman integration guide.

Example Response

Last Modified: 8 Jun 2023