> **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>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-play.mdx>

---

# Google Play API. Android app data as JSON.

Full app pages, reviews, charts, search, suggestions and developer catalogues, in the storefront and language you ask for.

- 170 storefronts
- 9 JSON routes
- 1 credit per request

Social Fetch exposes nine routes under `/v1/google-play`. Look up one app by its package name (`com.spotify.music`) or Google Play link with `GET /v1/google-play/apps/{appId}`: you get everything the store page shows, from the full description, rating histogram and install count to the developer's contact details, permissions, data safety summary and similar apps. Read reviews with `GET /v1/google-play/apps/{appId}/reviews`, newest or most relevant first, filtered by stars, up to 150 a page with a cursor.

Charts (`GET /v1/google-play/charts`) rank up to 200 apps for top free, top paid, top grossing, new and trending, in any category. Search returns the store's own results for a keyword, with a free or paid filter, and the suggestions route completes a partial query. `GET /v1/google-play/developers/{developerId}` lists every app a developer publishes. Every route takes a two-letter `country` and a `language`; three reference routes list the accepted categories, storefronts and languages. Responses use the `{ data, meta }` envelope with `data.lookupStatus`.

## What you can get

- One app by package name or link: ratings and histogram, installs, price, in-app purchases, ads, content rating, version, release and update dates, what's new, screenshots and video.
- Developer contact details as the store lists them: email, website, address, phone and privacy policy.
- Permissions by group and the data safety summary the developer declared.
- Reviews up to 150 a page with star filters, three sorts, helpful counts, app versions and developer replies.
- Top free, paid, grossing, new and trending charts of up to 200 apps, in any category.
- Store search with a free or paid filter, and the search suggestions the store shows.
- Every app a developer publishes, paged with a cursor.

## Google Play endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| App | GET /v1/google-play/apps/{appId} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/apps/appid/get) |
| Reviews | GET /v1/google-play/apps/{appId}/reviews | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/apps/appid/reviews/get) |
| Developer | GET /v1/google-play/developers/{developerId} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/developers/developerid/get) |
| Search | GET /v1/google-play/apps/search | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/apps/search/get) |
| Search suggestions | GET /v1/google-play/suggestions | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/suggestions/get) |
| Charts | GET /v1/google-play/charts | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/charts/get) |
| Categories | GET /v1/google-play/categories | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/categories/get) |
| Storefronts | GET /v1/google-play/storefronts | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/storefronts/get) |
| Languages | GET /v1/google-play/languages | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/google-play/languages/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_...`). New accounts get 100 free credits, enough to try every Google Play route.
2. **Pick the route, country and language.** Use `GET /v1/google-play/apps/com.spotify.music?country=gb` for one app, or `GET /v1/google-play/charts?chart=top-free&category=GAME` for a chart. Send `x-api-key` on every request.
3. **Branch on the answer.** Check `data.lookupStatus` before you store a row, follow `data.page.nextCursor` while `data.page.hasMore` is true, and bill from `meta.creditsCharged`.

## Pricing

Each Google Play route charges one credit per completed request, and each page of reviews or of a developer's apps is a separate request. Invalid input (an unknown country, language or category, or a cursor from another request) is refused before any work and costs nothing. `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Google Play has no public API for store listings, reviews of other developers' apps or charts. Social Fetch returns them in one `{ data, meta }` envelope with `lookupStatus`, echoes the storefront and language back, keeps one app card shape across search, charts and developer lists, and uses the same API key and credit meter as the rest of Social Fetch.

## FAQ

### Is there a Google Play API?

Yes. Social Fetch has nine Google Play routes under /v1/google-play: app, reviews, developer, search, search suggestions, charts, and the category, storefront and language lists. Authenticate with your Social Fetch API key in x-api-key.

### How do I look up an app?

Use GET /v1/google-play/apps/{appId} with the Android package name, for example com.spotify.music, or a Google Play link. Read data.lookupStatus: found puts the app in data.app, not_found puts null there.

### Which country and language should I use?

Pass a two-letter country, for example us, gb or jp, and a language such as en, de or pt-BR. Ratings, prices, charts and search follow the country; names, descriptions and review text follow the language. GET /v1/google-play/storefronts and GET /v1/google-play/languages list every accepted value.

### How do I read all reviews of an app?

Call GET /v1/google-play/apps/{appId}/reviews with limit up to 150, then pass data.page.nextCursor as cursor while data.page.hasMore is true. Keep the same sort and stars on every page: a cursor only works with the request it came from.

### How deep do charts go?

Google Play ranks up to 200 apps in a chart. Pass chart (top-free, top-paid, top-grossing, new-free, new-paid or trending), a category such as GAME or SOCIAL, and limit up to 200. Small categories rank fewer apps.

### How many results does search return?

Search returns what the store shows for a query: its featured exact match first, then the store's results, often 30 or 50 on the first page. Broad queries have more pages: pass data.page.nextCursor as cursor while data.page.hasMore is true. Use price=free or price=paid to filter. A query with no match returns an empty list.

### How much does the Google Play API cost?

Each route charges one credit per completed request; each page is a separate request. Refused input costs nothing. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

### Does HTTP 200 mean the app exists?

No. HTTP 200 means the request finished. Check data.lookupStatus on the app, reviews and developer routes: not_found means Google Play has no such app or developer.

## Related

- [App API](https://www.socialfetch.dev/platforms/google-play/apps-appid): Everything an app's store page shows (`GET /v1/google-play/apps/{appId}`).
- [Reviews API](https://www.socialfetch.dev/platforms/google-play/apps-appid-reviews): Reviews with star filters and developer replies (`GET /v1/google-play/apps/{appId}/reviews`).
- [Charts API](https://www.socialfetch.dev/platforms/google-play/charts): Top free, paid, grossing, new and trending charts (`GET /v1/google-play/charts`).
- [Search API](https://www.socialfetch.dev/platforms/google-play/apps-search): The store's search results for a keyword (`GET /v1/google-play/apps/search`).
- [Developer API](https://www.socialfetch.dev/platforms/google-play/developers-developerid): A developer and every app they publish (`GET /v1/google-play/developers/{developerId}`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Google Play question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Google Play tools from Cursor or Claude with the same credit metering as REST.
