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
Key | Datatype | Required | Description |
---|---|---|---|
limit | number | Number of items to include in the response | |
page | number | Offset by this many pages, of the size of limit | |
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
| |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
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"total_row_count":1,"timeframe":[1610028123,1610114523],"data":[{"value":"Chrome","total_count":5}]}