# Content Analysis Summary API (https://www.socialcrawl.dev/platforms/content_analysis/summary)

> Returns a single roll-up over every web citation of the keyword: total mention count, top domains, sentiment-connotation totals, positive/negative/neutral splits, top text + page categories, and breakdowns by page type, country, and language. The fastest way to size and characterize a brand's web-wide footprint in one call.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | Brand or term to summarize. |
| `page_type` | no | Narrow to one or more page types (comma-separated): ecommerce, news, blogs, message-boards, organization. (ecommerce \| news \| blogs \| message-boards \| organization) |
| `positive_connotation_threshold` | no | Minimum positive-connotation probability (0–1, default 0.4) for a mention to count as positive. |
| `sentiments_connotation_threshold` | no | Minimum sentiment-connotation probability (0–1, default 0.4) for the 6-axis emotion buckets. |
| `internal_list_limit` | no | Cap on internal arrays such as top_domains / categories (1–20). |
| `filters` | no | Advanced DataForSEO filter expression as a JSON array (≤8 conditions). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/content_analysis/summary?keyword=openai" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a roll-up of brand mentions in one call?

Send a GET request to /v1/content_analysis/summary with the keyword parameter. Instead of paging through every mention, you get one aggregate object: total mention count, top domains, sentiment totals, positive/negative/neutral split, top categories, and breakdowns by page type, country, and language.

### What does the media monitoring summary return?

It returns the total web-mention count for the keyword, the top domains citing it, overall sentiment totals, the positive/negative/neutral connotation split, the leading content categories, and per-page-type, per-country, and per-language breakdowns — a one-call dashboard for any term.

### When should I use summary instead of search?

Use summary when you want the shape of mention volume and sentiment for a keyword without reading individual pages, and search when you need the actual mentions. A common flow is summary first to size the conversation, then search to drill into specific mentions.

### Can I tune the sentiment thresholds in the summary?

Yes. Optional positive_connotation_threshold and sentiments_connotation_threshold control where the model splits positive, negative, and neutral, and internal_list_limit caps the top-N lists. Leave them unset to use SocialCrawl's defaults.

### How much does the media monitoring summary cost?

Each summary request costs 5 credits on the advanced tier — one call replaces paging through thousands of mentions. New accounts get 100 free credits with no credit card required, so you can profile several brands before you pay.

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 get a one-call roll-up of brand mentions with the SocialCrawl API
- What does the SocialCrawl content analysis summary endpoint return?