## content_analysis/rating-distribution

`GET /v1/content_analysis/rating-distribution`

Real 1-5 star histogram for a keyword that resolves to an App Store app, built from actual published reviews plus Apple's own lifetime average. If the keyword resolves to nothing rateable it returns 404 — no histogram is ever synthesised.

*Keyword rating distribution*

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | Name of a rateable entity — currently an App Store app — e.g. `Spotify` |
| `country` | no | 2-letter App Store storefront (default us); filters=location_code:eq:gb works too — e.g. `us` |
| `depth` | no | Pages of up to 50 reviews to sample (max 5) — e.g. `3` |
| `filters` | no | Only location_code applies here — see /v1/content_analysis/filters — e.g. `location_code:eq:gb` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/content_analysis/rating-distribution?keyword=Spotify" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "distribution": [
    {
      "count": 0,
      "rating": 0,
      "share": 0
    }
  ],
  "filters_applied": [],
  "histogram": {},
  "keyword": "example",
  "mean_rating": 0,
  "resolved_entity": {
    "developer": "example",
    "exact_name_match": false,
    "id": "example",
    "name": "example",
    "search_rank": 0,
    "type": "example",
    "url": "https://example.com/example"
  },
  "reviews_sampled": 0,
  "sources": [
    {
      "endpoint": "example",
      "ok": false,
      "returned": 0,
      "source": "example"
    }
  ],
  "sources_unavailable": [
    {
      "reason": "example",
      "source": "example"
    }
  ],
  "store_reported": {
    "average_rating": 0,
    "note": "example",
    "rating_count": 0
  },
  "storefront": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/content_analysis/rating-distribution#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/content_analysis/rating-distribution.json)