# (Deprecated) Fetch stream target live viewer data

The GET /usage/stream_targets/{id}/live operation is deprecated and no longer available. To retrieve live viewer data for a stream target, use GET /analytics/viewers/stream_targets/{id} endpoint.

Endpoint: GET /usage/stream_targets/{id}/live
Version: v1.11

## Path parameters:

  - `id` (string, required)
    The unique alphanumeric string that identifies the stream target.

## Response 200 fields (application/json):

  - `stream_target` (object)
    Example: {"id":"tvctq36g","unique_viewers":7,"countries":[{"code":"US","unique_viewers":4},{"code":"DE","unique_viewers":3}],"viewer_trend":[{"sampled_at":"2023-05-26T12:01:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:02:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:03:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:04:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:05:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:06:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:07:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:08:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:09:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:10:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:11:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:12:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:13:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:14:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:15:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:16:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:17:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:18:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:19:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:20:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:21:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:22:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:23:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:24:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:25:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:26:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:27:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:28:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:29:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:30:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:31:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:32:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:33:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:34:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:35:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:36:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:37:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:38:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:39:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:40:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:41:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:42:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:43:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:44:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:45:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:46:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:47:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:48:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:49:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:50:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:51:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:52:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:53:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:54:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:55:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:56:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:57:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:58:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:59:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:60:00Z","unique_viewers":7}]}

  - `stream_target.id` (string)
    The unique alphanumeric string that identifies the stream target.
    Example: "tvctq36g"

  - `stream_target.unique_viewers` (integer)
    The total number of unique viewers to download at least one chunk of the stream at the target (for HTTP streams). A unique viewer is a single IP address; multiple users that share the same IP address are counted once.
    Example: 7

  - `stream_target.countries` (object)
    (Available since 1.8) An array of viewer countries.
    Example: [{"code":"US","unique_viewers":4},{"code":"DE","unique_viewers":3}]

  - `stream_target.countries.code` (string)
    A country code where the stream was requested.

  - `stream_target.viewer_trend` (object)
    (Available since 1.8) An array of viewer trend data. Returns one data point per minute for the past hour.
    Example: [{"sampled_at":"2023-05-26T12:01:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:02:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:03:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:04:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:05:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:06:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:07:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:08:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:09:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:10:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:11:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:12:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:13:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:14:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:15:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:16:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:17:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:18:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:19:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:20:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:21:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:22:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:23:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:24:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:25:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:26:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:27:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:28:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:29:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:30:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:31:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:32:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:33:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:34:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:35:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:36:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:37:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:38:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:39:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:40:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:41:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:42:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:43:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:44:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:45:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:46:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:47:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:48:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:49:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:50:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:51:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:52:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:53:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:54:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:55:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:56:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:57:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:58:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:59:00Z","unique_viewers":7},{"sampled_at":"2023-05-26T12:60:00Z","unique_viewers":7}]

  - `stream_target.viewer_trend.sampled_at` (string)
    The date and time the trend data was sampled.

## Response 401 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 403 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 404 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 410 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 422 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)