# Content Analysis Sentiment API (https://www.socialcrawl.dev/platforms/content_analysis/sentiment)

> Returns two sentiment distributions for the keyword's web mentions: a positive/negative/neutral split (each a full summary sub-object) and a 6-axis emotional split (anger, happiness, love, sadness, share, fun — each a full summary sub-object). Sentiment is DataForSEO's model-derived NLP, passed through verbatim — not ground truth.

TL;DR: `GET /v1/content_analysis/sentiment` 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 analyze. |
| `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). |
| `filters` | no | Advanced DataForSEO filter expression as a JSON array (≤8 conditions). |

## Code example

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

## FAQ

### How do I run sentiment analysis on brand mentions?

Send a GET request to /v1/content_analysis/sentiment with the keyword parameter. You get two distributions back: the positive/negative/neutral connotation split and the 6-axis emotion split (anger, happiness, love, sadness, share, fun), each as a full summary sub-object.

### Is the sentiment ground truth or model output?

It is model-derived NLP, not ground truth. The sentiment analysis API returns the probabilities the model assigned across web mentions of your keyword. SocialCrawl passes those values through verbatim, so apply your own confidence thresholds before acting on them.

### What is the 6-axis emotion model?

Beyond the positive/negative/neutral split, each mention is scored on six emotional axes — anger, happiness, love, sadness, share, and fun. The sentiment endpoint aggregates those into a distribution so you can see which emotions dominate the conversation around a term.

### How is sentiment different from the summary endpoint?

Summary gives you mention totals, top domains, categories, and breakdowns plus sentiment totals. The sentiment endpoint focuses purely on the two distributions — connotation and 6-axis emotion — when emotional makeup is what you care about, not volume or sources.

### How much does the sentiment analysis API cost?

Each sentiment request costs 5 credits on the advanced tier. New accounts get 100 free credits with no credit card required, so you can compare the emotional profile of several brands or terms before you pay anything.

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 the sentiment distribution of brand mentions with the SocialCrawl API
- Is the SocialCrawl content analysis sentiment model-derived or ground truth?