---
title: "Most mentioned entities with faceting"
description: "Find most mentioned entities in articles with faceting, entity filters, and source quality"
source: https://apitube.io/cookbook/most-mentioned-entities-with-faceting
---

#### Input parameters

| Parameter            | Description                                    | Type    | Default | Required |
|:---------------------|:-----------------------------------------------|:--------|:--------|:---------|
| facet                | Enable faceting.                                 | boolean | true    | Yes      |
| facet.field          | Field to facet on (entity.id).                   | string  |         | Yes      |
| facet.limit          | Maximum facet values.                            | integer | 20      | Yes      |
| is_verified_source   | Filter verified sources.                         | integer | 1       | Yes      |
| source.rank.opr.min  | Minimum source quality.                         | string  |         | Yes      |
| published_at.start   | Start date filter.                              | string  |         | Yes      |
| api_key              | Your API key.                                  | string  |         | Yes      |
| per_page             | Maximum number of articles to retrieve.       | integer | 30      | No       |

#### Workflow examples

##### Request for most mentioned entities:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?facet=true&facet.field=entity.id&facet.limit=20&api_key=YOUR_API_KEY"
```

##### Request for entity correlation analysis:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268,1282301&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"
```

---

#### Related Examples

- [Entity correlation analysis](/cookbook/entity-correlation-analysis-with-time-series)
- [Cross-reference person with organizations](/cookbook/cross-reference-person-with-organizations-and-locations)
- [Filter articles mentioning persons](/cookbook/filter-articles-mentioning-persons)
- [Competitive intelligence analysis](/cookbook/competitive-intelligence-analysis-with-sentiment-tracking)
- [Sort by engagement score](/cookbook/sort-articles-by-engagement-score)