# Content Analysis Locations API (https://www.socialcrawl.dev/platforms/content_analysis/locations)

> Returns the list of locations supported by the Content Analysis endpoints. Static reference data — use it to interpret the `country` field on mentions. Heavily cached.

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

## FAQ

### How do I list supported locations for content analysis?

Send a GET request to /v1/content_analysis/locations. You get the full list of locations the content analysis API supports, so you can scope brand mention and sentiment queries by geography rather than searching the whole web at once.

### What does the locations endpoint return?

It returns a static reference list of supported locations plus a total count. Use these when you want to constrain mention and sentiment results to specific geographies, the same way the languages endpoint scopes by language.

### Is the locations list a live query or static reference?

It is static reference data, not a live mention query. The list changes rarely, so SocialCrawl caches it and repeat calls are effectively free in practice. Fetch it once and reuse the values across your other content analysis calls.

### How much does the locations endpoint cost?

Locations is a standard-tier reference endpoint at 1 credit per call, versus 5 credits for the analytic endpoints. New accounts get 100 free credits with no credit card required, so you can pull the full list at no real cost.

### Why would I need the locations list?

It lets you filter brand mentions and sentiment by geography reliably instead of guessing region values. Locations is one of the four reference endpoints — alongside languages, categories, and filters — that support the analytic calls.

See the full Content Analysis API: https://www.socialcrawl.dev/platforms/content_analysis

## 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 list supported locations for the SocialCrawl content analysis API
- Can I scope brand mentions by geography with the SocialCrawl API?