# Content Analysis Rating Distribution API (https://www.socialcrawl.dev/platforms/content_analysis/rating-distribution)

> Returns a 10-bucket histogram (0.0–0.1 … 0.9–1.0) of the relative ratings found across web mentions of the keyword. Each bucket carries a full summary sub-object (total_count, top_domains, sentiment, categories, page types, countries, languages) so you can see how sentiment and sources vary with rating. Best for products and review-heavy terms.

TL;DR: `GET /v1/content_analysis/rating-distribution` 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 | Product or term to build the rating histogram for. |
| `page_type` | no | Narrow to one or more page types (comma-separated): ecommerce, news, blogs, message-boards, organization. (ecommerce \| news \| blogs \| message-boards \| organization) |
| `filters` | no | Advanced DataForSEO filter expression as a JSON array (≤8 conditions). |

## Code example

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

## FAQ

### How do I get a rating histogram for brand mentions?

Send a GET request to /v1/content_analysis/rating-distribution with the keyword parameter. You get a 10-bucket histogram of the relative ratings across web mentions of that term — buckets running 0.0–0.1 through 0.9–1.0 — with each bucket carrying its own summary.

### What do the 10 buckets represent?

Each bucket spans a tenth of the rating scale, from 0.0–0.1 up to 0.9–1.0, and counts how many mentions of the keyword fall in that band. The shape of the histogram tells you whether the conversation skews favorable, unfavorable, or middling at a glance.

### How is rating-distribution different from sentiment?

Sentiment returns connotation and 6-axis emotion distributions; rating-distribution buckets mentions by their relative rating into a histogram. Use rating-distribution when you want to see how opinion clusters across a 0-to-1 scale rather than its emotional makeup.

### Is the rating data model-derived?

Yes. Like the rest of the content analysis API, the ratings come from DataForSEO's NLP over web pages, not from human reviews. SocialCrawl passes the values through verbatim, so treat the histogram as a model estimate and set your own thresholds.

### How much does the rating distribution API cost?

Each rating-distribution request costs 5 credits on the advanced tier. New accounts get 100 free credits with no credit card required, so you can chart the rating spread for several keywords 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 a rating histogram of brand mentions with the SocialCrawl API
- What are the 10 buckets in the SocialCrawl rating distribution endpoint?