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
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. |
Integer. Minimum 1. |
|
rank_max |
optional |
Maximum value of rank. |
Integer. Maximum 100. |
|
difficulty_min |
optional |
Minimum value of difficulty. |
Integer - Minimum 0. |
|
difficulty_max |
optional |
Maximum value of difficulty. |
Integer. Maximum 100. |
|
traffic_min |
optional |
Minimum value of traffic. |
Integer. Minimum 0. |
|
traffic_max |
optional |
Maximum value of traffic. |
Integer. 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 |
Integer. 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.
|
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 |
Integer |
Number of results found |
num_pages |
Integer |
Maximum number of pages it's possible to iterate |
has_next |
Boolean |
Flag indicating if there is a next page available |
limit |
Integer |
Number of results per request |
page |
Integer |
Current page number |
results |
Array of Objects |
Each object contains:
keyword - string
difficulty - Estimation of how competitive a specific keyword is to target:
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 - integer
|
|
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 |
Last Modified: 14 Jul 2022