# Content Analysis Categories API (https://www.socialcrawl.dev/platforms/content_analysis/categories)

> Returns the full content-category taxonomy (3,000+ nodes: category_code, category_name, parent code) used by Content Analysis. Use it to look up a `category_code` for the category-trends endpoint and to decode the numeric `text_category` arrays on mentions. Heavily cached.

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

## FAQ

### How do I browse the content category taxonomy?

Send a GET request to /v1/content_analysis/categories. You get the full content-category taxonomy — over 3,000 nodes — as JSON, so you can find the numeric category_code for any topic and feed it to the category-trends endpoint.

### How big is the categories taxonomy?

The taxonomy has 3,000+ nodes covering topics from apparel to technology. Each node carries a numeric code; for example, Apparel is 10021. Browse the tree to locate the exact code that matches the content category you want to track.

### What is the category_code used for?

The category-trends endpoint keys on a numeric category_code, not a keyword. You look the code up here in the categories taxonomy, then pass it to category-trends to chart mention volume and sentiment for that whole category over time.

### Is the categories list static or live?

It is static reference data, not a live mention query. The taxonomy changes rarely, so SocialCrawl caches it and repeat calls are effectively free in practice. Pull it once, find your codes, and reuse them across category-trends calls.

### How much does the categories endpoint cost?

Categories is a standard-tier reference endpoint at 1 credit per call, versus 5 credits for analytic endpoints. New accounts get 100 free credits with no credit card required, so you can pull the whole taxonomy 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 a content category_code with the SocialCrawl API
- How big is the SocialCrawl content analysis category taxonomy?