App Store
Search Filter v.2

Get Filter Search

Fields
NameTypeSortDescription
namestring-Name
bundlestring-Bundle
description_fullstring-Full Description
publishedboolean-Published
listing_visibleboolean-Published in request country
categorystring-Сategory
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
removal_datedate ISO8601+Removal date
versionstring-Version
sizefloat-Size
rating_countinteger+Ratings
rating_valuefloat+Rating in request country
review_countinteger+Reviews
rating_avgfloat+Rating
iapboolean-Inapp
copyrightstring-Copyright
sellerstring-Seller
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
active_countries[]string["US", "DE", "FR"] - List of countries where app is available (At least one country)
categorystringApp Store category: "TRAVEL", "EDUCATION", "GAMES_STRATEGY", "LIFESTYLE" etc
review_countValueRange{"gte": 1000, "lte": 5000}
rating_avgValueRange{"gte": 3.5, "lte": 5.0}
with_adsbooleanWith Ads
advertisedbooleanAdvertised
post/ios/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/ios/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'

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_month",
  "fields": [
    "id",
    "name",
    "icon",
    "video",
    "category_type",
    "category",
    "url_appstorespy"
  ],
  "language": "en_US",
  "filter": {
    "name": "twitter",
    "published": true,
    "category_type": "APP",
    "release_date": {
      "lte": "2026-10-12"
    },
    "update_date": {
      "lte": "2026-10-12"
    },
    "rating_count": {
      "lte": 1000000,
      "gte": 0
    },
    "active_countries": [
      "US"
    ]
  }
}

Response

Successful Response

total_countinteger

Changes

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