---
title: "Combined regular and range faceting"
description: "Use both regular faceting and range faceting together for comprehensive analytics"
source: https://apitube.io/cookbook/combined-regular-and-range-faceting
---

#### Input parameters

| Parameter            | Description                                    | Type    | Default | Required |
|:---------------------|:-----------------------------------------------|:--------|:--------|:---------|
| title                | Search query.                                   | string  |         | Yes      |
| facet                | Enable regular faceting.                        | boolean | true    | Yes      |
| facet.field          | Fields for regular faceting.                    | string  |         | Yes      |
| facet.range          | Enable range faceting.                          | boolean | true    | Yes      |
| facet.range.field    | Field for range faceting.                       | string  |         | Yes      |
| facet.range.start    | Start value for range.                          | string  |         | Yes      |
| facet.range.end       | End value for range.                            | string  |         | Yes      |
| facet.range.gap       | Gap between ranges (e.g., 1MONTH).              | string  |         | Yes      |
| api_key              | Your API key.                                  | string  |         | Yes      |
| per_page             | Maximum number of articles to retrieve.       | integer | 20      | No       |

#### Workflow examples

##### Request for combined regular and range faceting:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?title=climate&facet=true&facet.field=source.country.id,language.id&facet.range=true&facet.range.field=published_at&facet.range.start=2024-01-01&facet.range.end=2024-06-01&facet.range.gap=1MONTH&api_key=YOUR_API_KEY"
```

##### Request for sentiment timeline dashboard:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Nike&facet.range=true&facet.range.field=published_at&facet.range.start=2024-01-01&facet.range.end=2024-12-31&facet.range.gap=1MONTH&sentiment.overall.polarity=positive&api_key=YOUR_API_KEY"
```

##### Request for media richness timeline:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?has_image=1&facet.range=true&facet.range.field=media.images.count&facet.range.start=1&facet.range.end=20&facet.range.gap=2&api_key=YOUR_API_KEY"
```

---

#### Related Examples

- [Advanced faceting with multiple filters](/cookbook/advanced-faceting-with-multiple-filters)
- [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)
- [Select specific fields](/cookbook/select-specific-fields-to-reduce-payload-size)
- [Get articles with high-quality images](/cookbook/get-articles-with-high-quality-images)