---
title: "Sort articles by controversy score"
description: "Find polarizing and debate-worthy topics sorted by controversy detector"
source: https://apitube.io/cookbook/sort-articles-by-controversy-score
---

#### Input parameters

| Parameter   | Description                                    | Type    | Default | Required |
|:------------|:-----------------------------------------------|:--------|:--------|:---------|
| sort.by     | Sort by controversy score.                     | string  |         | Yes      |
| sort.order  | Sort order (desc for most controversial).      | string  |         | Yes      |
| category.id | Category filter (optional).                    | string  |         | No       |
| api_key     | Your API key.                                  | string  |         | Yes      |
| per_page    | Maximum number of articles to retrieve.       | integer | 20      | No       |

#### Workflow examples

##### Request for controversial/polarizing topics:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?sort.by=controversy&sort.order=desc&category.id=medtop:11000000&api_key=YOUR_API_KEY"
```

---

#### Related Examples

- [Sort by engagement score](/cookbook/sort-articles-by-engagement-score)
- [Sort by quality score](/cookbook/sort-articles-by-quality-score)
- [Sort by trust score](/cookbook/sort-articles-by-trust-score)
- [Find articles with mixed sentiment](/cookbook/find-articles-with-mixed-sentiment)
- [Get sorted news by date](/cookbook/get-sorted-news)