AppstoreSpy API

{"openapi":"3.1.0","info":{"title":"AppstoreSpy API","description":"# Authentication\n\nThe Appstorespy API uses API-KEY authentication.<br>\n\nIf you do not have an API Key token, you can get it on your account page [https://appstorespy.com/account](https://appstorespy.com/account). <br>\n\nAn API Key is required to be sent as part of every request in request header.\n\n```\n\n    -H 'accept: application/json'\n\n    -H 'API-KEY: <your_token>'\n\n```\n\n\n\n# Fields\n\nUse the fields parameter to specify which fields should be returned. <br>\n\nExample:\n\n```\n\n    Request: fields=name,developer_name,ipd,downloads,...\n\n    Response: {name: ..., developer_name: ..., ipd: ..., downloads: ..., ...}\n\n```\n\nDon`t use fields parameter if you need to get all fields. <br>\n\n\n\n\n\n# Sort\n\nWhen you use search, you can add a sort parameter.\n\n```\n\n    Request: sort=ratingCount\n\n    Response: [{name: app1, ratingCount: 4.2}, {name: app2, ratingCount: 4.4}, ...]\n\n```\n\nIf you need DESC sorting add \"-\" before sort parametr.\n\n```\n\n    Request: sort=-ratingCount\n\n    Response: [{name: app2, ratingCount: 4.4}, {name: app1, ratingCount: 4.2}, ...]\n\n```\n\n\n\n# County & Language params\n\n...\n\n\n\n# Status codes / Error codes\n\n* 200 OK.\n\n* 202 Accepted - The app was not present in our databases and has been submitted for crawling. If the app is available anywhere, it will be available soon.\n\n* 204 No Content - No data for requested country.\n\n* 403 Forbidden - Your access token is not valid.\n\n* 429 Too Many Requests - Your request rate is over the limit.\n","version":"0.0.1"},"servers":[{"url":"https://api.appstorespy.com/v1"}],"paths":{"/ios/apps/{id}":{"get":{"tags":["App Store"],"summary":"Get App Store app by ID.","operationId":"get_app_details_ios_apps__id__get","parameters":[{"description":"App ID","required":true,"schema":{"type":"string","title":"Id","description":"App ID"},"example":"333903271","name":"id","in":"path"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"},{"description":"Country for which return data. By default: US.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppCountries"}],"description":"Country for which return data. By default: US."},"name":"country","in":"query"},{"description":"Language of meta data. By default: store default language.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppLanguages"}],"description":"Language of meta data. By default: store default language."},"name":"language","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosApp"}}}},"206":{"description":"Partial Content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosApp"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/apps":{"get":{"tags":["App Store"],"summary":"Search App Store apps by query.","operationId":"get_app_search_ios_apps_get","parameters":[{"description":"Word or phrase for search.","required":false,"schema":{"type":"string","title":"Q","description":"Word or phrase for search."},"example":"Twitter","name":"q","in":"query"},{"description":"Country for specific country fields. Default - US.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppCountries"}],"description":"Country for specific country fields. Default - US."},"name":"country","in":"query"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"},{"description":"Sort params separated by comma(,)","required":false,"schema":{"type":"string","title":"Sort","description":"Sort params separated by comma(,)"},"example":"-revenue","name":"sort","in":"query"},{"description":"Count per page","required":false,"schema":{"type":"integer","maximum":1000.0,"title":"Limit","description":"Count per page","default":10},"name":"limit","in":"query"},{"description":"Page","required":false,"schema":{"type":"integer","title":"Page","description":"Page","default":1},"name":"page","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/IosApp"},"type":"array","title":"Response Get App Search Ios Apps Get"}},"text/csv":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/apps/{id}/reviews":{"get":{"tags":["App Store"],"summary":"Get App Store app reviews by app ID.","operationId":"get_reviews_ios_apps__id__reviews_get","parameters":[{"description":"App ID","required":true,"schema":{"type":"string","title":"Id","description":"App ID"},"example":"333903271","name":"id","in":"path"},{"description":"App storefront","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppCountries"}],"description":"App storefront"},"name":"country","in":"query"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"},{"description":"Count of reviews per page","required":false,"schema":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Limit","description":"Count of reviews per page","default":10},"name":"limit","in":"query"},{"description":"Sort params separated by comma(,)","required":false,"schema":{"type":"string","title":"Sort","description":"Sort params separated by comma(,)"},"example":"rating,-date","name":"sort","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/IosReview"},"type":"array","title":"Response Get Reviews Ios Apps  Id  Reviews Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/apps/query":{"post":{"tags":["App Store","Search Filter v.2"],"summary":"Get Filter Search","description":"|**Fields**||||\n|---|---|---|---|\n|**Name**         |**Type**    |**Sort**|**Description**|\n|name             |string      |-   |Name|\n|bundle           |string      |-   |Bundle|\n|description_full |string      |-   |Full Description|\n|published        |boolean     |-   |Published|\n|listing_visible  |boolean     |-   |Published in request country|\n|category         |string      |-   |Сategory|\n|category_type    |string      |-   |Type|\n|revenue_month    |integer     |+   |Monthly Revenue|\n|revenue_lifetime |integer     |-   |Lifetime Revenue|\n|downloads_month  |integer     |+   |Monthly Downloads|\n|downloads_lifetime|integer    |-   |Lifetime Downloads|\n|update_date      |date ISO8601|+   |Last Updated|\n|release_date     |date ISO8601|+   |Release date|\n|developer_name   |string      |-   |Developer name|\n|description_short|string      |-   |Short description|\n|whatsnew         |string      |-   |Whatsnew|\n|icon             |string      |-   |Image|\n|video            |string      |-   |Trailer|\n|screenshots      |[]string    |-   |Screenshots|\n|removal_date     |date ISO8601|+   |Removal date|\n|version          |string      |-   |Version|\n|size             |float       |-   |Size|\n|rating_count     |integer     |+   |Ratings|\n|rating_value     |float       |+   |Rating in request country|\n|review_count     |integer     |+   |Reviews|\n|rating_avg       |float       |+   |Rating|\n|iap              |boolean     |-   |Inapp|\n|copyright        |string      |-   |Copyright|\n|seller           |string      |-   |Seller|\n|chart_info       |object      |+   |App's chart info: category, collection, country, position for today|\n\n\n|**Filters**|||\n|---|---|---|\n|**Name**|**Type**|**Description**|\n|name|string|Name|\n|published|boolean|Published|\n|category_type|string|APP or GAME|\n|revenue_month|ValueRange|{\"gte\": 100, \"lte\": 500} (In this field you need write values in thousands: 100 = 100000, 500 = 500000)|\n|downloads_month|ValueRange|{\"gte\": 100, \"lte\": 500} (In this field you need write values in thousands: 100 = 100000, 500 = 500000)|\n|update_date|DateRange|{\"gte\": \"2021-01-01\", \"lte\": \"2022-01-01\"}|\n|release_date|DateRange|{\"gte\": \"2021-01-01\", \"lte\": \"2022-01-01\"}|\n|rating_count|ValueRange|{\"gte\": 1000, \"lte\": 5000}|\n|developer|string|Developer name|\n|developer_id|string|Developer id|\n|active_countries|[]string|[\"US\", \"DE\", \"FR\"] - List of countries where app is available (At least one country)|\n|category|string|App Store category: \"TRAVEL\", \"EDUCATION\", \"GAMES_STRATEGY\", \"LIFESTYLE\" etc|\n|review_count|ValueRange|{\"gte\": 1000, \"lte\": 5000}|\n|rating_avg|ValueRange|{\"gte\": 3.5, \"lte\": 5.0}|\n|with_ads|boolean|With Ads|\n|advertised|boolean|Advertised|","operationId":"get_filter_search_ios_apps_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosAppSearchBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosAppListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/apps/similar":{"post":{"tags":["App Store"],"summary":"Get Similar","operationId":"get_similar_ios_apps_similar_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosSimilarSearchBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosAppListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/apps/summary":{"post":{"tags":["App Store"],"summary":"Get Summary","operationId":"get_summary_ios_apps_summary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosSummarySearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/apps/{id}/recrawl":{"get":{"tags":["App Store"],"summary":"Get Recrawl","operationId":"get_recrawl_ios_apps__id__recrawl_get","parameters":[{"description":"App ID(bundle)","required":true,"schema":{"type":"string","title":"Id","description":"App ID(bundle)"},"example":"com.twitter.android","name":"id","in":"path"},{"description":"Country for which return data. By default: US.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppCountries"}],"description":"Country for which return data. By default: US.","default":"US"},"name":"country","in":"query"},{"description":"Language of meta data. By default: en_US","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppLanguages"}],"description":"Language of meta data. By default: en_US","default":"en_US"},"name":"language","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/estimates":{"get":{"tags":["App Store"],"summary":"Get Apps Estimates","description":"Get App Store apps estimates","operationId":"get_apps_estimates_ios_estimates_get","parameters":[{"description":"Apps to return separated by comma(,)","required":true,"schema":{"type":"string","title":"Id","description":"Apps to return separated by comma(,)"},"example":"333903271","name":"id","in":"query"},{"description":"Start date. Format YYYY-MM-DD","required":false,"schema":{"type":"string","format":"date","title":"Start","description":"Start date. Format YYYY-MM-DD"},"name":"start","in":"query"},{"description":"Start date. Format YYYY-MM-DD","required":false,"schema":{"type":"string","format":"date","title":"End","description":"Start date. Format YYYY-MM-DD"},"name":"end","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AppsEstimates"},"type":"array","title":"Response Get Apps Estimates Ios Estimates Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/info/countries":{"get":{"tags":["App Store"],"summary":"Get Ios app available countries.","operationId":"get_play_app_countries_ios_info_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCountries"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/info/languages":{"get":{"tags":["App Store"],"summary":"Get Ios app available languages.","operationId":"get_play_app_languages_ios_info_languages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreLanguages"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/developers/{id}":{"get":{"tags":["App Store"],"summary":"Get Developer","operationId":"get_developer_ios_developers__id__get","parameters":[{"description":"Developer ID","required":true,"schema":{"type":"string","title":"Id","description":"Developer ID"},"example":"1641486560","name":"id","in":"path"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IosDev"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/developers":{"get":{"tags":["App Store"],"summary":"Dev Search","operationId":"dev_search_ios_developers_get","parameters":[{"description":"Query for search","required":false,"schema":{"type":"string","title":"Q","description":"Query for search"},"example":"hq_country:US","name":"q","in":"query"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"},{"description":"Sort params separated by comma(,)","required":false,"schema":{"type":"string","title":"Sort","description":"Sort params separated by comma(,)"},"example":"-total_apps,-installs","name":"sort","in":"query"},{"description":"Count per page","required":false,"schema":{"type":"integer","maximum":1000.0,"title":"Limit","description":"Count per page","default":10},"name":"limit","in":"query"},{"description":"Page","required":false,"schema":{"type":"integer","title":"Page","description":"Page","default":1},"name":"page","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/IosDev"},"type":"array","title":"Response Dev Search Ios Developers Get"}},"text/csv":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/developers/{id}/estimates":{"get":{"tags":["App Store"],"summary":"Get Apps Estimates","description":"Get Google Play apps estimates","operationId":"get_apps_estimates_ios_developers__id__estimates_get","parameters":[{"description":"Developer's ids to return separated by comma(,)","required":true,"schema":{"type":"string","title":"Id","description":"Developer's ids to return separated by comma(,)"},"example":"296415947","name":"id","in":"path"},{"description":"Start date. Format YYYY-MM-DD","required":false,"schema":{"type":"string","format":"date","title":"Start","description":"Start date. Format YYYY-MM-DD"},"name":"start","in":"query"},{"description":"Start date. Format YYYY-MM-DD","required":false,"schema":{"type":"string","format":"date","title":"End","description":"Start date. Format YYYY-MM-DD"},"name":"end","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DevAppsEstimates"},"type":"array","title":"Response Get Apps Estimates Ios Developers  Id  Estimates Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/ios/rankings":{"get":{"tags":["App Store"],"summary":"Get App Store rankings data","operationId":"get_ios_rankings_ios_rankings_get","parameters":[{"description":"Start date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date","title":"Date Start","description":"Start date (YYYY-MM-DD)"},"name":"date_start","in":"query"},{"description":"End date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date","title":"Date End","description":"End date (YYYY-MM-DD)"},"name":"date_end","in":"query"},{"description":"App IDs (comma-separated)","required":false,"schema":{"items":{"type":"integer"},"type":"array","title":"App","description":"App IDs (comma-separated)"},"name":"app","in":"query"},{"description":"Platforms (iPhone/iPad, comma-separated)","required":false,"schema":{"items":{"$ref":"#/components/schemas/IosPlatform"},"type":"array","description":"Platforms (iPhone/iPad, comma-separated)"},"name":"platform","in":"query"},{"description":"Country codes (comma-separated)","required":false,"schema":{"items":{"$ref":"#/components/schemas/AppCountries"},"type":"array","description":"Country codes (comma-separated)"},"name":"country","in":"query"},{"description":"App categories (comma-separated)","required":false,"schema":{"items":{"$ref":"#/components/schemas/IosCategory"},"type":"array","description":"App categories (comma-separated)"},"name":"category","in":"query"},{"description":"Collection types (comma-separated)","required":false,"schema":{"items":{"$ref":"#/components/schemas/Collection"},"type":"array","description":"Collection types (comma-separated)"},"name":"collection","in":"query"},{"description":"Minimum rank","required":false,"schema":{"type":"integer","minimum":1.0,"title":"Rank Start","description":"Minimum rank"},"name":"rank_start","in":"query"},{"description":"Maximum rank","required":false,"schema":{"type":"integer","maximum":10000.0,"title":"Rank End","description":"Maximum rank"},"name":"rank_end","in":"query"},{"description":"Count per page","required":false,"schema":{"type":"integer","maximum":1000.0,"title":"Limit","description":"Count per page","default":10},"name":"limit","in":"query"},{"description":"Page","required":false,"schema":{"type":"integer","title":"Page","description":"Page","default":1},"name":"page","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_models.responses.response.IosRankingItem__"}},"text/csv":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/jobs/search":{"get":{"tags":["Jobs"],"summary":"Get Search","operationId":"get_search_jobs_search_get","parameters":[{"required":false,"schema":{"$ref":"#/components/schemas/Store"},"name":"store","in":"query"},{"required":false,"schema":{"type":"string","title":"Term"},"name":"term","in":"query"},{"required":false,"schema":{"type":"string","title":"Id User"},"name":"id_user","in":"query"},{"required":false,"schema":{"type":"string","title":"Country"},"name":"country","in":"query"},{"required":false,"schema":{"type":"string","title":"Search Id"},"name":"search_id","in":"query"},{"required":false,"schema":{"type":"string","format":"date-time","title":"Updated Gte"},"example":"2020-01-01T00:00:00+00:00","name":"updated_gte","in":"query"},{"required":false,"schema":{"type":"string","format":"date-time","title":"Updated Lte"},"example":"2022-01-01T00:00:00+00:00","name":"updated_lte","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SearchResult"},"type":"array","title":"Response Get Search Jobs Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["Jobs"],"summary":"Create Search","operationId":"create_search_jobs_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/apps":{"get":{"tags":["Google Play"],"summary":"Search Google Play apps by query.","operationId":"get_app_search_play_apps_get","parameters":[{"description":"Word or phrase for search.","required":false,"schema":{"type":"string","title":"Q","description":"Word or phrase for search."},"example":"X","name":"q","in":"query"},{"description":"Empty for all.","required":false,"schema":{"type":"boolean","title":"Published","description":"Empty for all."},"name":"published","in":"query"},{"description":"Country for specific country fields. Default - US.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppCountries"}],"description":"Country for specific country fields. Default - US."},"name":"country","in":"query"},{"description":"Language of meta data. By default: store default language.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppLanguages"}],"description":"Language of meta data. By default: store default language."},"name":"language","in":"query"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"},{"description":"Sort params separated by comma(,)","required":false,"schema":{"type":"string","title":"Sort","description":"Sort params separated by comma(,)"},"example":"-installs_exact,-revenue","name":"sort","in":"query"},{"description":"Count per page","required":false,"schema":{"type":"integer","maximum":1000.0,"title":"Limit","description":"Count per page","default":10},"name":"limit","in":"query"},{"description":"Page","required":false,"schema":{"type":"integer","title":"Page","description":"Page","default":1},"name":"page","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PlayApp"},"type":"array","title":"Response Get App Search Play Apps Get"}},"text/csv":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/apps/{id}/reviews":{"get":{"tags":["Google Play"],"summary":"Get Google Play app reviews by app ID.","operationId":"get_reviews_play_apps__id__reviews_get","parameters":[{"description":"App ID(bundle)","required":true,"schema":{"type":"string","title":"Id","description":"App ID(bundle)"},"example":"com.twitter.android","name":"id","in":"path"},{"required":false,"schema":{"$ref":"#/components/schemas/AppCountries"},"name":"country","in":"query"},{"description":"Review language","required":true,"schema":{"allOf":[{"$ref":"#/components/schemas/AppLanguages"}],"description":"Review language"},"name":"language","in":"query"},{"description":"Count of reviews per page","required":false,"schema":{"type":"integer","maximum":1000.0,"title":"Limit","description":"Count of reviews per page","default":10},"name":"limit","in":"query"},{"description":"Sort params separated by comma(,)","required":false,"schema":{"type":"string","title":"Sort","description":"Sort params separated by comma(,)"},"example":"stars,-likes","name":"sort","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PlayReview"},"type":"array","title":"Response Get Reviews Play Apps  Id  Reviews Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/apps/{id}/recrawl":{"get":{"tags":["Google Play"],"summary":"Get Recrawl","operationId":"get_recrawl_play_apps__id__recrawl_get","parameters":[{"description":"App ID(bundle)","required":true,"schema":{"type":"string","title":"Id","description":"App ID(bundle)"},"example":"com.twitter.android","name":"id","in":"path"},{"description":"Country for which return data. By default: US.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppCountries"}],"description":"Country for which return data. By default: US.","default":"US"},"name":"country","in":"query"},{"description":"Language of meta data. By default: en_US","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppLanguages"}],"description":"Language of meta data. By default: en_US","default":"en_US"},"name":"language","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/apps/query":{"post":{"tags":["Google Play"],"summary":"Get Filter Search","operationId":"get_filter_search_play_apps_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayAppSearchBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayAppListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/apps/similar":{"post":{"tags":["Google Play"],"summary":"Get Similar","operationId":"get_similar_play_apps_similar_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimilarSearchBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayAppListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/apps/summary":{"post":{"tags":["Google Play"],"summary":"Get Summary","operationId":"get_summary_play_apps_summary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummarySearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/apps/{id}":{"get":{"tags":["Google Play"],"summary":"Get Google Play app by ID.","operationId":"get_app_details_play_apps__id__get","parameters":[{"description":"App ID(bundle)","required":true,"schema":{"type":"string","title":"Id","description":"App ID(bundle)"},"example":"com.twitter.android","name":"id","in":"path"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"},{"description":"Country for which return data. By default: US.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppCountries"}],"description":"Country for which return data. By default: US."},"name":"country","in":"query"},{"description":"Language of meta data. By default: store default language.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AppLanguages"}],"description":"Language of meta data. By default: store default language."},"name":"language","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayApp"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/info/countries":{"get":{"tags":["Google Play"],"summary":"Get Google Play app available countries.","description":"This query returns the list of Google Play app available countries.","operationId":"get_play_app_countries_play_info_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCountries"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/info/languages":{"get":{"tags":["Google Play"],"summary":"Get Google Play app available languages.","description":"This query returns the list of Google Play app available languages.","operationId":"get_play_app_languages_play_info_languages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreLanguages"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/developers/{id}":{"get":{"tags":["Google Play"],"summary":"Get Developer","operationId":"get_developer_play_developers__id__get","parameters":[{"description":"Developer ID","required":true,"schema":{"type":"string","title":"Id","description":"Developer ID"},"example":"6891936352065498609","name":"id","in":"path"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayDev"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/play/developers":{"get":{"tags":["Google Play"],"summary":"Dev Search","operationId":"dev_search_play_developers_get","parameters":[{"description":"Query for search","required":false,"schema":{"type":"string","title":"Q","description":"Query for search"},"example":"hq_country:US","name":"q","in":"query"},{"description":"Fields to return separated by comma(,)","required":false,"schema":{"type":"string","title":"Fields","description":"Fields to return separated by comma(,)"},"name":"fields","in":"query"},{"description":"Sort params separated by comma(,)","required":false,"schema":{"type":"string","title":"Sort","description":"Sort params separated by comma(,)"},"example":"-total_apps,-installs","name":"sort","in":"query"},{"description":"Count per page","required":false,"schema":{"type":"integer","maximum":1000.0,"title":"Limit","description":"Count per page","default":10},"name":"limit","in":"query"},{"description":"Page","required":false,"schema":{"type":"integer","title":"Page","description":"Page","default":1},"name":"page","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"i

# --- truncated at 32 KB (89 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/appstorespy/refs/heads/main/openapi/appstorespy-openapi.json