---
title: "Filter articles mentioning events"
description: "Get articles that mention at least one event entity"
source: https://apitube.io/cookbook/filter-articles-mentioning-events
---

#### Input parameters

| Parameter        | Description                                    | Type    | Default | Required |
|:-----------------|:-----------------------------------------------|:--------|:--------|:---------|
| event.name       | Event name to filter by (e.g., "Olympics"). | string  |         | Yes      |
| published_at.start | Start date 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 articles mentioning an event:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?event.name=Olympics&published_at.start=2024-01-01&api_key=YOUR_API_KEY"
```

##### Request for articles about specific event:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?event.name=Olympics&api_key=YOUR_API_KEY"
```

##### Request for event coverage sentiment analysis:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?event.name=CES&sentiment.overall.polarity=positive&published_at.start=2024-01-01&sort.by=sentiment.overall.score&api_key=YOUR_API_KEY"
```

---

#### Related Examples

- [Filter articles mentioning persons](/cookbook/filter-articles-mentioning-persons)
- [Filter articles mentioning disasters](/cookbook/filter-articles-mentioning-disasters)
- [Multi-dimensional sentiment analysis](/cookbook/multi-dimensional-sentiment-analysis-with-source-filtering)
- [Get news on a specific date](/cookbook/get-news-on-date)
- [Get sorted news by date](/cookbook/get-sorted-news)