Google Play

Get the Google Play listing of an app in any language.

Returns the store listing of one app for a country and language exactly as Google Play serves it: title, short and full description, what's new, icon, feature graphic, trailer and screenshots. Any language Google Play Console accepts can be requested. The listing is crawled on demand and kept; freshness sets how old a kept listing may be before it is crawled again. A call waits for a running crawl for up to about 30 seconds and answers 202 with the crawl state if it is still running; repeat the same request to get the listing. Pass wait=false to get the 202 immediately. Repeated requests for the same listing share one crawl. translated tells whether Google Play machine-translated the texts instead of showing a translation the developer supplied. The call that queues a crawl costs the crawl price, even when it answers 202; a call served from a kept listing, including a kept not-found, costs the read price; a 202 to a call that found the crawl already running costs nothing, and so do a 422, a 429 and any 5xx, a failed crawl (502) included.

get/play/apps/{id}/listing

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/{id}/listing
  • Auth: API key in header API-KEY

Path parameters

idstring required

App ID(bundle)

Query parameters

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.

Country of the listing (Google Play gl). By default: US.

language'af' | 'sq' | 'am' | 'ar' | 'hy_AM' | 'az_AZ' | 'bn_BD' | 'eu_ES' | 'be' | 'bg' | 'my_MM' | 'ca' | 'zh_HK' | 'zh_CN' | 'zh_TW' | 'hr' | 'cs_CZ' | 'da_DK' | 'nl_NL' | 'en_IN' | 'en_SG' | 'en_ZA' | 'en_AU' | 'en_CA' | 'en_GB' | 'en_US' | 'et' | 'fil' | 'fi_FI' | 'fr_CA' | 'fr_FR' | 'gl_ES' | 'ka_GE' | 'de_DE' | 'el_GR' | 'gu' | 'iw_IL' | 'hi_IN' | 'hu_HU' | 'is_IS' | 'id' | 'it_IT' | 'ja_JP' | 'kn_IN' | 'kk' | 'km_KH' | 'ko_KR' | 'ky_KG' | 'lo_LA' | 'lv' | 'lt' | 'mk_MK' | 'ms' | 'ms_MY' | 'ml_IN' | 'mr_IN' | 'mn_MN' | 'ne_NP' | 'no_NO' | 'fa' | 'fa_AE' | 'fa_AF' | 'fa_IR' | 'pl_PL' | 'pt_BR' | 'pt_PT' | 'pa' | 'ro' | 'rm' | 'ru_RU' | 'sr' | 'si_LK' | 'sk' | 'sl' | 'es_419' | 'es_ES' | 'es_US' | 'sw' | 'sv_SE' | 'ta_IN' | 'te_IN' | 'th' | 'tr_TR' | 'uk' | 'ur' | 'vi' | 'zu'

Every locale Google Play Console accepts for a store listing. Used by the live listing endpoint, which crawls Google Play directly and is not limited by the languages stored in Elasticsearch (see AppLanguages).

Language of the listing (Google Play hl), any Google Play Console locale. By default: en_US.

freshness'1d' | '7d' | '30d'

An enumeration.

How old a kept listing may be before it is crawled again.

waitboolean

Wait for a running crawl, or answer 202 right away.

Response

The listing

idstring required

The app package name

countrystring required

Country the listing was requested for (Google Play gl)

languagestring required

Language the listing was requested in (Google Play hl)

crawledstring date-time required

When Google Play was crawled, UTC

urlstring required

Link to the listing on Google Play for this country and language

namestring required

Title as shown on Google Play

shortstring

Short description as shown on Google Play

descriptionstring

Full description as shown on Google Play

whatsnewstring

What's new as shown on Google Play

iconstring

Icon URL

featurestring

Feature graphic URL

trailerstring

Promo video Youtube link

screenshotsstring[] required

Screenshot URLs in the order Google Play shows them

translatedboolean required

True when the developer has not supplied this language and Google Play shows a machine translation of the default listing; short and description are then that translation. False means the texts are the developer's own: a listing in this language, or the default listing when Google Play does not translate it.

translated_fromstring

Source language of the machine translation, as Google Play names it in the requested language

Changes

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