# App Store Locations API (https://www.socialcrawl.dev/platforms/app_store/locations)

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

TL;DR: `GET /v1/app_store/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/app_store/locations" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get supported Apple App Store locations via API?

Send a GET request to /v1/app_store/locations. The response is the reference list of Apple App Store storefronts, each with the numeric location code and name you pass as the country parameter on app-search, app-list, app-info, and app-reviews.

### What is the App Store locations endpoint for?

It is a reference lookup for the storefronts you can target. The location codes it returns are valid values for the country parameter on the app endpoints, so you can search and chart the Apple App Store storefront by storefront.

### What fields does each App Store location include?

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

### How much does the App Store 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 App Store location codes?

Apple App Store results vary by storefront — rankings, availability, and pricing differ by country. Passing a valid location code lets you pull the right regional iOS view instead of defaulting to the US storefront.

See the full App Store API: https://www.socialcrawl.dev/platforms/app_store

## 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 Apple App Store storefront locations via API
- What location codes does the SocialCrawl App Store API accept?