GooglePlay API endpoint
Lists apps from a Google Play chart. `collection` is `TOP_FREE`, `TOP_PAID`, `GROSSING`, `NEW_FREE` or `NEW_PAID`, and `category`, `device`, `age`, `num`, `country` and `lang` narrow it. Set `full_detail` to get full app details instead of the compact card.
/googleplay/listMCP tool: googleplay_list
Returns Google Play chart or collection listings.
collection allowed values: TOP_FREE, TOP_PAID, GROSSING, NEW_FREE, NEW_PAID.
device optionally scopes the listing to a Google Play device tab. Allowed
values: phone, tablet, tv, chromebook, watch, xr, car.
category accepts Google Play app category ids, including APPLICATION,
ANDROID_WEAR, ART_AND_DESIGN, AUTO_AND_VEHICLES, BEAUTY,
BOOKS_AND_REFERENCE, BUSINESS, COMICS, COMMUNICATION, DATING,
EDUCATION, ENTERTAINMENT, EVENTS, FAMILY, FINANCE,
FOOD_AND_DRINK, GAME, GAME_ACTION, GAME_ADVENTURE, GAME_ARCADE,
GAME_BOARD, GAME_CARD, GAME_CASINO, GAME_CASUAL,
GAME_EDUCATIONAL, GAME_MUSIC, GAME_PUZZLE, GAME_RACING,
GAME_ROLE_PLAYING, GAME_SIMULATION, GAME_SPORTS, GAME_STRATEGY,
GAME_TRIVIA, GAME_WORD, HEALTH_AND_FITNESS, HOUSE_AND_HOME,
LIBRARIES_AND_DEMO, LIFESTYLE, MAPS_AND_NAVIGATION, MEDICAL,
MUSIC_AND_AUDIO, NEWS_AND_MAGAZINES, PARENTING, PERSONALIZATION,
PHOTOGRAPHY, PRODUCTIVITY, SHOPPING, SOCIAL, SPORTS, TOOLS,
TRAVEL_AND_LOCAL, VIDEO_PLAYERS, WATCH_FACE, and WEATHER.
age allowed values: AGE_RANGE1, AGE_RANGE2, AGE_RANGE3.
| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| title | 40 | “Muse from Meta” and 39 other values |
| app_id | 40 | |
| url | 40 | play.google.com |
| icon | 40 | play-lh.googleusercontent.com |
| developer | 40 | “Meta Platforms, Inc.” and 33 other values |
| summary | 40 | median 2,568 characters |
| score_text | 40 | 3.2 to 4.9, median 4.5 |
| score | 40 | 3.17 to 4.85, median 4.5 |
| price_text | 40 | FREE in all 40 |
| price | 40 | 0 |
| free | 40 | true in 40 of 40 |
| currency | 40 | USD in all 40 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| collection | string | No | Collection: TOP_FREE, TOP_PAID, GROSSING, NEW_FREE, NEW_PAID Allowed values: TOP_FREE, TOP_PAID, GROSSING, NEW_FREE, NEW_PAID. | TOP_FREE | |
| category | string | No | Category id | TOOLS | |
| device | string | No | Google Play device tab: phone, tablet, tv, chromebook, watch, xr, car Allowed values: phone, tablet, tv, chromebook, watch, xr, car. | tablet | |
| age | string | No | Family age range | AGE_RANGE1 | |
| num | integer | No | Number of apps | 50 | |
| country | string | No | Two-letter country code | us | |
| lang | string | No | Two-letter language code | en | |
| full_detail | boolean | No | Resolve each app to full detail | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/googleplay/list?collection=TOP_FREE&device=phone&num=10&country=us&lang=en&full_detail=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": [
{
"app_id": "com.openai.chatgpt",
"title": "ChatGPT",
"developer": "OpenAI",
"score": 4.8
}
]
}Request schema
No body schema
Response schema
#/definitions/googleplay.listResultsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | array | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/googleplay/list?collection=TOP_FREE&device=phone&num=10&country=us&lang=en&full_detail=true" \
-H "x-api-key: $CRAWLORA_API_KEY"