---
title: "Retrieve apps from a Google Play top collection"
method: GET
path: "/googleplay/list"
tags: ["GooglePlay"]
---

# Retrieve apps from a Google Play top collection

`GET /googleplay/list`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/googleplay/list`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `collection` 'TOP_FREE' | 'TOP_PAID' | 'GROSSING' | 'NEW_FREE' | 'NEW_PAID'
- `category` string
- `device` 'phone' | 'tablet' | 'tv' | 'chromebook' | 'watch' | 'xr' | 'car'
- `age` string
- `num` integer
- `country` string
- `lang` string
- `full_detail` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoogleplayListResultsResponseDoc
  - `code` integer
  - `data` unknown[]
    - unknown
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)