Advanced Query API for Android Apps

age_approved_by_teachers

optional

Filter apps by Google Play Age Approved By Teachers

JSON object with the format:

{
  "any": [
    "Teacher Approved"
  ],
  "all": [
    "Teacher Approved"
  ]
}

List of Google Play Age Approved By Teachers.

price_flag optional Filter apps by price in USD. "free"
"paid" Tiny

price_gte optional Price greater than or equal to given value. Any double value. Tiny

price_lte optional Price less than or equal to given value. Any double value. Tiny

iap optional Whether the apps should support in-app purchases or not. "with_iap"
"without_iap" Tiny

contains_ads optional Whether the apps displays ads. true
false Tiny

rating_gte optional Rating greater than or equal to given value. Any double value between 0.0 and 5.0 Tiny

rating_lte optional Rating less than or equal to given value. Any double value between 0.0 and 5.0 Tiny

ratings_count_gte optional Number of ratings greater than or equal to given value. Any long value ≥ 0 Tiny

ratings_count_lte optional Number of ratings less than or equal to given value. Any long value ≥ 0 Tiny

downloads_gte optional Number of downloads greater than or equal to given value. Any long value ≥ 0 which is a valid download bracket start - e.g. 100, 500, 1000, 5000, etc. Tiny

downloads_lte optional Number of downloads less than or equal to given value. Any long value ≥ 0 which is a valid download bracket end - e.g. 100, 500, 1000, 5000, etc. Tiny

content_rating optional Filter apps by content rating. Multiple content ratings are interpreted as an OR. "Unrated"
"Everyone"
"Everyone 10+"
"Teen"
"Mature 17+" Tiny

editors_choice optional Filter apps whether they have are marked as Editors' Choice. true
false Tiny

promo_video optional Whether or not an app has a promotional video. true, false Tiny

i18n_lang

optional

Filter apps by supported languages (of their description).

JSON object with the format:

{
  "any": {
    "lang": [
      "LANGUAGE_CODE_1",
      "LANGUAGE_CODE_2"
    ]
  },
  "all": {
    "lang": [
      "LANGUAGE_CODE_3"
    ]
  },
  "none": {
    "lang": [
      "LANGUAGE_CODE_4"
    ]
  },
}

where "LANGUAGE_CODE" is one of the supported language codes.

A request for apps only translated in selected languages can be done with the optional "only" flag.

{
  "all": {
    "lang": [
      "LANGUAGE_CODE"
    ],
    "only": true
  }
}

sort

optional

Sort returned apps by a sorting criteria.

Value	Description
number_ratings	Sort by number of ratings
score	Search score based on app popularity and search relevance (if full text search is used). sort_order is automatically set to 'desc' to show most relevant matches.
rating	Sort by rating
price	Sort by price
size	Sort by size
alphabetical	Sort alphabetically
market_update	Sort by Last Update Date
unpublished_timestamp	Sort by Unpublished Timestamp
created	Sort by Release Date
downloads	Sort by Downloads
relevance	Pure search relevance of search term. Only together with full_text_term. sort_order is automatically set to 'desc' to show most relevant matches.

number_ratings

sort_order optional Sort ordering. desc
asc desc Tiny

from optional Return results starting from result number. Overridden by a page and limit GET parameters. Maximum of 10000 apps can be iterated. 0 Tiny

num optional Number of results to return. Overridden by a page and limit GET parameters. Maximum of 50 apps can be returned with one query. 50 Tiny

domain_search_term optional Full-text search in the website/domain fields for gplay apps. The domain search term. Tiny

domain_search_in optional Domain search in the following fields. List of strings. Available options are:
"website"
"email" Tiny

domain_exact_match optional Exact match flag for domain search, no full-text matching. true,false Tiny

physical_address optional Search for a term in the Physical Address of developers. E.g. search for a city - 'London'. Search term Small

publisher_geo_context

optional

Filter apps by publisher country of residence. Useful to discover apps developer in a particular country.

JSON object with the format:

{
  "any": {
    "country": [
      "COUNTRY_CODE_1",
      "COUNTRY_CODE_2"
    ]
  }
}

where "COUNTRY_CODE" is one of the supported country codes.

Small

released_after_dynamic optional Filter apps by "released timestamp". "last_day"
"last_week"
"last_month" Small

released_after optional Released after a particular date. Date string in ISO 8601 format,
YYYY-MM-DD
e.g.
"2016-05-31". Small

released_before optional Released before a particular date. Date string in ISO 8601 format,
YYYY-MM-DD
e.g.
"2016-05-31". Small

unpublished_after optional Unpublished after a particular date. Date string in ISO 8601 format,
YYYY-MM-DD
e.g.
"2016-05-31".
or one of
"last_day"
"last_week"
"last_month" Small

unpublished_before optional Unpublished before a particular date. Date string in ISO 8601 format,
YYYY-MM-DD
e.g.
"2016-05-31". Small

market_update_dynamic optional Filter apps by "updated timestamp". "last_day"
"last_week"
"last_month" Small

market_update_after optional Updated after a particular date. Date string in ISO 8601 format,
YYYY-MM-DD
e.g.
"2016-05-31". Small

market_update_before optional Updated before a particular date. Date string in ISO 8601 format,
YYYY-MM-DD
e.g.
"2019-05-31". Small

ranking

optional

Filter apps whether they appear in any Top Charts.

JSON object with the format:

{
  "list_name": "_ANY",
  "cat_key": "_ANY",
  "country": "_ANY",
  "rank_gte": 0,
  "rank_lte": 600
}

Available values for list_name, cat_key, country can be seen on Apple App Store Top Charts docs.

Small

privacy_policy optional Whether or not an app has 'privacy policy url' or not. true, false Small

available_in

optional

Filter apps by supported countries.

JSON object with the format:

{
  "any": {
    "country": [
      "COUNTRY_CODE_1",
      "COUNTRY_CODE_2"
    ]
  },
  "all": {
    "country": [
      "COUNTRY_CODE_3"
    ]
  },
  "none": {
    "country": [
      "COUNTRY_CODE_4"
    ]
  },
}

where "COUNTRY_CODE" is one of the supported country codes.

A request for apps only available in selected country can be done with the optional "only" flag.

{
  "all": {
    "country": [
      "COUNTRY_CODE"
    ],
    "only": true
  }
}

Small

iab

optional

Filter apps by IAB Categories.

JSON object with the format:

{
  "any": [
    {
      "id": IAB_ID,
      "type": "inferred"
    }
  ],
  "all": [
    {
      "id": IAB_ID,
      "type": "declared_by_dev"
    }
  ]
}

where IAB_ID is the id of a valid IAB Category and "type" is optional, defaulting to "inferred" or "declared_by_dev".

more_like_this

optional

Find apps that are "like" or "unlike" a set of another apps. Based on textual description.

JSON object with the format:

{
  "like": [
    "PACKAGE_NAME_1",
    "PACKAGE_NAME_2",
    ..
  ],
  "unlike": [
    "PACKAGE_NAME_3",
    ..
  ]
}

At least one entry in "like" or "unlike" is required.

review_analysis

optional

Filter apps based on review sentiment and review topics.

JSON object with the format:

{
  "all": [
    {
      "topic_id": "TOPIC_ID",
      "sentiment": "SENTIMENT"
    }
  ]
}

Available values for topic_id can be found on Review Topics. Available values for sentiment parameter are positive or negative.

any_permissions

optional

Filter apps based on a list of permissions. The list of permissions is interpreted as an OR clause.

Our supported list of Android permissions. For example

[
  "android.permission.INTERNET"
]

all_permissions

optional

Filter apps based on a list of permissions. The list of permissions is interpreted as an AND clause.

Our supported list of Android permissions. For example

[
  "android.permission.INTERNET"
]

any_sdks

optional

Filter apps based on a list of SDK IDs. The list of SDK IDs is interpreted as an OR clause.

List of Android SDK IDs. For example

[
  "google-ads-admob"
]

all_sdks

optional

Filter apps based on a list of SDK IDs. The list of SDK IDs is interpreted as an AND clause.

List of Android SDK IDs. For example

[
  "google-ads-admob"
]

none_sdks

optional

Filter apps based on a negative list of SDK IDs. None of the given SDKs should be present in the resulting set of apps.

List of Android SDK IDs. For example

[
  "google-ads-admob"
]

interactive_elements

optional

Filter apps by Google Play Interactive Elements

JSON object with the format:

{
  "any": [
    "Users Interact",
    "Shares Info"
  ],
  "all": [
    "Digital Purchases",
    "In-App Purchases"
  ]
}

List of Google Play Interactive Elements.

app_ads_txt

optional

Filter apps by App-ads.txt records.

JSON object with the format:

{
  "any": [
    {
      "ad_domain_name": "AD_DOMAIN_NAME",
      "rel": "RELATIONSHIP",
      "pub_acc_id": "PUBLISHER_ACCOUNT_ID",
      "ca_id": "CERTIFICATE_AUTHORITY_ID"
    }
  ],
  "all": [
    {
      "ad_domain_name": "AD_DOMAIN_NAME",
      "rel": "RELATIONSHIP",
      "pub_acc_id": "PUBLISHER_ACCOUNT_ID",
      "ca_id": "CERTIFICATE_AUTHORITY_ID"
    }
  ],
  "none": [
    {
      "ad_domain_name": "AD_DOMAIN_NAME",
      "rel": "RELATIONSHIP",
      "pub_acc_id": "PUBLISHER_ACCOUNT_ID",
      "ca_id": "CERTIFICATE_AUTHORITY_ID"
    }
  ]
}

For more information about what each field means in the context of App-ads.txt please refer to App-ads.txt schema docs

download_estimates

optional

Filter apps by estimated monthly downloads. period m1 = last month (default),m3 = last 3 months,m6 = last 6 months,y1 = last 12 months. For using period more than one month you need a Historical Data plan.

JSON object with the format:

{
  "all": [
    {
      "country": [
        "US",
        "DE"
      ],
      "gte": 0,
      "lte": 50,
      "period": "m3"
    }
  ],
  "any": [
    {
      "country": [
        "US"
      ],
      "gte": 0,
      "lte": 50,
      "period": "m3"
    },
    {
      "country": [
        "DE"
      ],
      "gte": 50,
      "lte": 100
    }
  ],
  "sum": [
    {
      "country": [
        "US",
        "DE"
      ],
      "gte": 0,
      "lte": 5000
    }
  ]
}

preregister optional Whether or not an app has a 'pre-register' flag or not. true, false Large

testing optional Whether or not an app has a 'testing' flag or not. true, false Large

mau

optional

Filter apps by last 30 days of monthly active users.

JSON object with the format:

{
  "all": [
    {
      "country": [
        "US",
        "DE"
      ],
      "gte": 0,
      "lte": 50
    }
  ],
  "any": [
    {
      "country": [
        "US"
      ],
      "gte": 0,
      "lte": 50
    },
    {
      "country": [
        "DE"
      ],
      "gte": 50,
      "lte": 100
    }
  ],
  "sum": [
    {
      "country": [
        "US",
        "DE"
      ],
      "gte": 0,
      "lte": 5000
    }
  ]
}

privacy

optional

Filter apps by privacy types. Official Google Play documentation.

JSON object with the format:

{
  "all": [
    {
      "type": "collected_data",
      "purpose": "DEVELOPER_COMMUNICATIONS"
    },
    {
      "type": "shared_data",
      "purpose": "ADVERTISING_OR_MARKETING",
      "data_category": "APP_INFO_AND_PERFORMANCE",
      "data_type": "Crash logs"
    }
  ],
  "any": [
    {
      "practice": "DELETABLE_DATA",
      "type": "security_practices"
    }
  ],
  "none": [
    {
      "data_type": "Approximate location"
    }
  ]
}

List of supported Privacy Types. Use IDs to query.