# Google Play Locations API (https://www.socialcrawl.dev/platforms/google_play/locations)

> Returns the locations (name + numeric location code) supported by the Google Play App Data endpoints. Use a code or name as the `country` param. Static reference data — heavily cached.

TL;DR: `GET /v1/google_play/locations` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google_play/locations" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get supported Google Play locations via API?

Send a GET request to /v1/google_play/locations. The response is the reference list of Google Play storefront locations, each with the code and name you pass as the location parameter on app-search, app-list, and app-info.

### What is the Google Play locations endpoint for?

It is a reference lookup for the storefronts you can target. The location codes it returns are the valid values for the location parameter on the app endpoints, so you can search and chart Google Play region by region.

### What fields does each location include?

Each entry includes a location code and a human-readable country or region name. You pass that code to app-search, app-list, app-info, and app-reviews to scope results to a specific Google Play storefront.

### How much does the locations endpoint cost?

Locations run on the standard tier at 1 credit per call, since it is a lightweight reference lookup. New accounts get 100 free credits with no credit card, so you can fetch the list at no real cost.

### Why do I need location codes?

Google Play results vary by storefront — rankings, availability, and pricing differ by country. Passing a valid location code lets you pull the right regional view instead of defaulting to one market.

See the full Google Play API: https://www.socialcrawl.dev/platforms/google_play

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get supported Google Play storefront locations via API
- What location codes does the SocialCrawl Google Play API accept?