Lists the values for a specific dimension
Lists the values for a dimension along with a total count of related views.
Note: This API replaces the list-filter-values API call.
Path parameters
ID of the Dimension
Query parameters
Number of items to include in the response
Offset by this many pages, of the size of limit
Filter results using key:value pairs. Must be provided as an array query string parameter.
Basic filtering:
- filters[]=dimension:value - Include rows where dimension equals value
- filters[]=!dimension:value - Exclude rows where dimension equals value
For trace dimensions (like video_cdn_trace):
- filters[]=+dimension:value - Include rows where trace contains value
- filters[]=-dimension:value - Exclude rows where trace contains value
- filters[]=dimension:[value1,value2] - Exact trace match
Examples:
- filters[]=country:US - US views only
- filters[]=+video_cdn_trace:fastly - Views using Fastly CDN
Limit the results to rows that match inequality conditions from provided metric comparison clauses. Must be provided as an array query string parameter.
Possible filterable metrics are the same as the set of metric ids, with the exceptions of exits_before_video_start, unique_viewers, video_startup_failure_percentage, view_dropped_percentage, and views.
Example:
- metric_filters[]=aggregate_startup_time>=1000
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
Response
OK