---
title: "Advanced faceting with multiple filters"
description: "Combine faceting with complex filters for comprehensive analytics dashboards"
source: https://apitube.io/cookbook/advanced-faceting-with-multiple-filters
---

#### Input parameters

| Parameter            | Description                                    | Type    | Default | Required |
|:---------------------|:-----------------------------------------------|:--------|:--------|:---------|
| title                | Search query.                                   | string  |         | Yes      |
| facet                | Enable faceting.                                | boolean | true    | Yes      |
| facet.field          | Multiple fields to facet on (comma-separated). | string  |         | Yes      |
| facet.limit          | Maximum facet values per field.                | integer | 10      | Yes      |
| published_at.start   | Start date filter.                              | string  |         | Yes      |
| source.rank.opr.min  | Minimum source quality.                         | string  |         | Yes      |
| api_key              | Your API key.                                  | string  |         | Yes      |
| per_page             | Maximum number of articles to retrieve.       | integer | 20      | No       |

#### Workflow examples

##### Request for advanced faceting with filters:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?title=AI&facet=true&facet.field=source.id,category.id,language.id,sentiment.overall.polarity&facet.limit=10&published_at.start=2024-01-01&source.rank.opr.min=5&api_key=YOUR_API_KEY"
```

##### Request for language distribution analysis:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Tesla&facet=true&facet.field=language.id,source.country.id&facet.limit=15&api_key=YOUR_API_KEY"
```

##### Request for media bias distribution:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=climate_change&facet=true&facet.field=source.bias,source.country.id&api_key=YOUR_API_KEY"
```

##### Request for temporal analysis - articles by hour:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?facet=true&facet.field=published.hour&published_at.start=2024-01-01&api_key=YOUR_API_KEY"
```

---

#### Related Examples

- [Get articles with faceting for analytics](/cookbook/get-articles-with-faceting-for-analytics)
- [Get articles with range faceting](/cookbook/get-articles-with-range-faceting-for-timelines)
- [Combined regular and range faceting](/cookbook/combined-regular-and-range-faceting)
- [Select specific fields](/cookbook/select-specific-fields-to-reduce-payload-size)
- [Sort by engagement score](/cookbook/sort-articles-by-engagement-score)