Google Play

Get Filter Search

Fields
NameTypeSortDescription
namestring-Name
bundlestring-Bundle
description_fullstring-Description
publishedboolean-Published
listing_visibleboolean-Published in request country
categorystring-Category
category_typestring-Type
revenue_monthinteger+Monthly Revenue
revenue_lifetimeinteger-Lifetime Revenue
downloads_monthinteger+Monthly Downloads
downloads_lifetimeinteger-Lifetime Downloads
update_datedate ISO8601+Last Updated
release_datedate ISO8601+Release date
developer_namestring-Developer name
description_shortstring-Short description
whatsnewstring-Whatsnew
iconstring-Image
videostring-Trailer
screenshots[]string-Screenshots
feature_graphicstring-Feature graphic
removal_datedate ISO8601+Removal date
versionstring-Version
sizefloat-Size
downloads_dailyinteger+Daily Installs
downloads_exactinteger+Total Installs
downloads_markinteger+Installs
rating_countinteger+Ratings
rating_valuefloat+Rating in request country
review_countinteger+Reviews
rating_avgfloat+Rating
iapboolean-Inapp
editorialboolean-Editor's choise
hosts[]string-Hosts
chart_infoobject+App's chart info: category, collection, country, position for today
Filters
NameTypeDescription
namestringName
publishedbooleanPublished
category_typestringAPP or GAME
revenue_monthValueRange{"gte": 100, "lte": 500} (In this field you need write values in thousands: 100 = 100000, 500 = 500000)
downloads_monthValueRange{"gte": 100, "lte": 500} (In this field you need write values in thousands: 100 = 100000, 500 = 500000)
update_dateDateRange{"gte": "2021-01-01", "lte": "2022-01-01"}
release_dateDateRange{"gte": "2021-01-01", "lte": "2022-01-01"}
rating_countValueRange{"gte": 1000, "lte": 5000}
developerstringDeveloper name
developer_idstringDeveloper id
editorialbooleanEditor's choise
iapbooleanInapp
active_countries[]string["US", "DE", "FR"] - List of countries where app is available (At least one country)
categorystringGoogle Play category: "GAME_ARCADE", "SOCIAL", "ART_AND_DESIGN", "LIFESTYLE" etc
downloads_markinteger100, 500, 1000, 5000, 10000 etc
downloads_dailyValueRange{"gte": 1000, "lte": 5000}
downloads_exactValueRange{"gte": 1000, "lte": 5000}
review_countValueRange{"gte": 1000, "lte": 5000}
similar_appsstring"com.twitter.android" - Twitter similar apps
reverse_similar_appsstring"com.twitter.android" - Apps with Twitter in similar's list
rating_avgValueRange{"gte": 3.5, "lte": 5.0}
hostsstring
with_adsbooleanWith Ads
advertisedbooleanAdvertised
post/play/apps/query

Request

  • Base URL: https://api.appstorespy.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.appstorespy.com/play/apps/query
  • Auth: API key in header API-KEY

Request body

limitinteger

Count of apps in results

pageinteger

Offset page

sort'revenue_month' | '-revenue_month' | 'downloads_month' | '-downloads_month' | 'update_date' | '-update_date' | 'release_date' | '-release_date' | 'removal_date' | '-removal_date' | 'downloads_exact' | '-downloads_exact' | 'downloads_mark' | '-downloads_mark' | 'rating_count' | '-rating_count' | 'rating_value' | '-rating_value' | 'review_count' | '-review_count' | 'rating_avg' | '-rating_avg' | 'chart_info' | '-chart_info' | 'downloads_daily' | '-downloads_daily'

An enumeration.

fieldsstring[]

Fields for select, empty for all

country'US' | 'CA' | 'AT' | 'BE' | 'CY' | 'CZ' | 'DK' | 'FI' | 'FR' | 'DE' | 'GR' | 'HU' | 'IE' | 'IT' | 'NL' | 'NO' | 'PL' | 'PT' | 'RU' | 'ES' | 'SE' | 'CH' | 'TR' | 'UA' | 'GB' | 'EG' | 'IN' | 'IL' | 'MA' | 'NG' | 'SA' | 'ZA' | 'AE' | 'AU' | 'HK' | 'ID' | 'JP' | 'KZ' | 'KR' | 'MY' | 'NZ' | 'PK' | 'PH' | 'SG' | 'TW' | 'TH' | 'VN' | 'AR' | 'BR' | 'MX'

An enumeration.

language'en_US' | 'ar' | 'en_GB' | 'fr_FR' | 'es_419' | 'de_DE' | 'pt_BR' | 'it_IT' | 'ja_JP' | 'ko_KR' | 'tr_TR' | 'ru_RU' | 'vi'

An enumeration.

Example request

{
  "sort": "-downloads_daily",
  "fields": [
    "id",
    "name",
    "icon",
    "video",
    "downloads_mark",
    "category_type",
    "category",
    "url_appstorespy"
  ],
  "language": "en_US",
  "filter": {
    "name": "twitter",
    "bundle": [
      "com.twitter.android",
      "com.facebook.katana"
    ],
    "published": true,
    "category_type": "APP",
    "release_date": {
      "lte": "2026-10-12"
    },
    "update_date": {
      "lte": "2026-10-12"
    },
    "rating_avg": {
      "lte": 5,
      "gte": 3
    },
    "rating_count": {
      "lte": 1000000,
      "gte": 0
    },
    "active_countries": [
      "US"
    ],
    "downloads_daily": {
      "lte": 100000,
      "gte": 0
    },
    "downloads_exact": {
      "lte": 1000000,
      "gte": 0
    }
  }
}

Response

Successful Response

total_countinteger

Changes

No recorded changes to this operation across all 1 revision of this API.