---
title: "Search Google Play"
method: GET
path: "/googleplay/search"
tags: ["GooglePlay"]
---

# Search Google Play

`GET /googleplay/search`

## Request

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

Searches Google Play for apps matching the required `term`, up to `num` results (default 20, max 250). `price` is `all` (default), `free` or `paid`, and `country` and `lang` default to `us` and `en`. A strong exact match is placed first. An empty list means no apps matched.

## Query parameters

- `term` string, required
- `num` integer
- `country` string
- `lang` string
- `full_detail` boolean
- `price` 'all' | 'free' | 'paid'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoogleplaySearchResultsResponseDoc
  - `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/afac9b012a27?raw)