> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/google-play/apps-search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-play/apps-search.mdx>

---

# Google Play Search API

The apps the store shows for a keyword, its featured match first, with a free or paid filter.

`GET /v1/google-play/apps/search` takes a `query`, an optional `country` and `language`, and `price` (`all`, `free` or `paid`). `data.results` lists the apps in the store's order: its featured exact match first when there is one, then the rest of the store's first page (often 30 or 50 apps). Each app has its id, name, link, icon, developer, rating, price, summary, category, install band, age rating, in-app purchase range and screenshots.

A broad query has more pages: while `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` with the same query, price, country and language. Later pages carry fewer fields per app (price, installs, category and age rating are null there). A query with no match returns an empty list.

## Request

- **Endpoint:** `GET /v1/google-play/apps/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by keyword
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/google-play/apps/search/get)
- **Platform page:** [/platforms/google-play](https://www.socialfetch.dev/platforms/google-play)

## FAQ

### How many results come back?

The store's first page: its featured exact match plus often 30 or 50 apps. Broad queries have more pages, up to about 50 apps each: pass data.page.nextCursor as cursor while data.page.hasMore is true. Each page is one request.

### How many credits does it cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### Can I search only paid apps?

Yes: price=paid. price=free returns free apps only.

### Do results differ by country?

Yes. Search follows the country, so pass the one your users are in.
