Lists values for a specific filter

GET {{baseUrl}}/data/v1/filters/:FILTER_ID

The API has been replaced by the list-dimension-values API call.

Lists the values for a filter along with a total count of related views.

Request Params

KeyDatatypeRequiredDescription
limitnumberNumber of items to include in the response
pagenumberOffset by this many pages, of the size of limit
filters[]stringLimit the results to rows that match conditions from provided key:value pairs. Must be provided as an array query string parameter.

To exclude rows that match a certain condition, prepend a ! character to the dimension.

Possible filter names are the same as returned by the List Filters endpoint.

Example:

  • filters[]=operating_system:windows&filters[]=!country:US | | filters[] | string | | Limit the results to rows that match conditions from provided key:value pairs. Must be provided as an array query string parameter.

To exclude rows that match a certain condition, prepend a ! character to the dimension.

Possible filter names are the same as returned by the List Filters endpoint.

Example:

  • filters[]=operating_system:windows&filters[]=!country:US | | timeframe[] | string | | Timeframe window to limit results by. Must be provided as an array query string parameter (e.g. timeframe[]=).

Accepted formats are...

  • array of epoch timestamps e.g. timeframe[]=1498867200&timeframe[]=1498953600
  • duration string e.g. timeframe[]=24:hours or timeframe[]=7:days | | timeframe[] | string | | Timeframe window to limit results by. Must be provided as an array query string parameter (e.g. timeframe[]=).

Accepted formats are...

  • array of epoch timestamps e.g. timeframe[]=1498867200&timeframe[]=1498953600
  • duration string e.g. timeframe[]=24:hours or timeframe[]=7:days |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"total_row_count":1,"timeframe":[1610028123,1610114523],"data":[{"value":"Chrome","total_count":5}]}