# Content Analysis Filters API (https://www.socialcrawl.dev/platforms/content_analysis/filters)

> Returns the map of filterable fields → value types (str, num, time, array.num, array.str) accepted by the advanced `filters` param on the search/summary/sentiment endpoints. Use it to build valid filter expressions. Heavily cached.

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

## FAQ

### How do I find the filterable fields for content analysis?

Send a GET request to /v1/content_analysis/filters. You get the map of every filterable field and the value type each expects, so you can build the advanced filters expression that search and summary accept for precise brand mention queries.

### What does the filters endpoint return?

It returns a field-to-type map: each filterable field paired with the kind of value it takes. Use it as the reference for constructing the filters parameter — a JSON array of conditions — when page_type alone is not specific enough.

### How do I use the filters in a search?

Pass an advanced filters expression as a JSON array (up to eight conditions) to the search or summary endpoint. The filters endpoint tells you which fields are valid and what value types they expect, so your expression is accepted on the first try.

### Is the filters map static or live?

It is static reference data, not a live mention query. The field map changes rarely, so SocialCrawl caches it and repeat calls are effectively free in practice. Fetch it once, build your filter expressions, and reuse them.

### How much does the filters endpoint cost?

Filters 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 field map at no real cost.

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 find the filterable fields for the SocialCrawl content analysis API
- How do I build an advanced filter expression for content analysis search?