The “include” parameter allows to enrich the API response with extra contextual data such as the total, the data type, etc.

Here’s how the parameter is formatted: &include={total:displayed,total:all,reference:space,context}.

total:displayed

“Displayed” total: corresponds to the total of metrics shown in your dataset (and therefore paginated, if you have more than 10,000 rows in your entire results data set). This is the sum of all displayed rows.

Example:

&include={total:displayed}

total:all

“Sum of all elements”: Corresponds to the total of metrics shown in your entire dataset, without notion of pagination. If you have more than 10, 000 rows, say, for example, 45,600 rows, we will display the sum of all 45,600 rows.

Example:&include={total:all}

reference:space

“Reference”: corresponds to the total of metrics of the site in question. This total allows you to therefore identify the proportion of data contained in your call compared to the total site-level metrics. This is the total sum of the chosen site.

Example:&include={reference:space}

context

This value allows you to capture information related to the metadata of the call: periods, perimeters, pagination, etc.