---
title: "Get show analytics"
method: GET
path: "/analytics/shows/{show_id}"
tags: ["Analytics"]
---

# Get show analytics

`GET /analytics/shows/{show_id}`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/analytics/shows/{show_id}`
- Auth: OAuth 2
  - Authorization code: `https://api.whatnot.com/seller-api/rest/oauth/authorize`
  - Token URL: `https://api.whatnot.com/seller-api/rest/oauth/token`

Retrieve the analytics for one show owned by the authenticated seller. A show without final analytics still returns 200 with null metrics and a `calculation_status` saying why: WILL_NOT_BE_CALCULATED if the show was cancelled, is private or is a rehearsal, NOT_ENDED if it has not ended, PENDING if it ended and the metrics are still being calculated. Requires read:reports.

## Path parameters

- `show_id` string, uuid, required

## Response `200`

Successful Response

- ShowAnalytics
  - `show_id` string, required: The show these analytics describe.
  - `title` string, required: The show's title.
  - `start_time` string, date-time, required: When the show started.
  - `calculation_status` 'WILL_NOT_BE_CALCULATED' | 'NOT_ENDED' | 'PENDING' | 'GENERATED', required
  - `sales` Money, required
    - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
    - `currency` string, required: ISO 4217 currency code.
  - `estimated_earnings` Money, required
    - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
    - `currency` string, required: ISO 4217 currency code.
  - `orders_count` integer, nullable, required: Number of orders.
  - `average_order_value` Money, required
    - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
    - `currency` string, required: ISO 4217 currency code.
  - `giveaway_orders_count` integer, nullable, required: Number of giveaway orders.
  - `giveaway_spend` Money, required
    - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
    - `currency` string, required: ISO 4217 currency code.
  - `show_impression_count` integer, nullable, required: Number of times the show was shown to viewers.
  - `show_clickthrough_rate` number, nullable, required: Percentage of impressions that were tapped, to two decimal places. Null when there were no impressions.
  - `buyers_count` integer, nullable, required: Number of distinct buyers.
  - `first_time_buyers_count` integer, nullable, required: Buyers purchasing from the seller for the first time.
  - `returning_buyers_count` integer, nullable, required: Buyers who had purchased from the seller before.
  - `giveaway_winners_count` integer, nullable, required: Number of distinct giveaway winners.
  - `first_time_giveaway_winners_count` integer, nullable, required: Giveaway winners who had not bought from the seller before.
  - `returning_giveaway_winners_count` integer, nullable, required: Giveaway winners who had bought from the seller before.
  - `buyer_shares_count` integer, nullable, required: Number of times buyers shared the show.
  - `stream_minutes` integer, nullable, required: Minutes the show ran.
  - `max_concurrent_viewers` integer, nullable, required: Peak number of simultaneous viewers.
  - `total_views` integer, nullable, required: Total views.
  - `distinct_viewers_count` integer, nullable, required: Number of distinct viewers.
  - `average_rating` number, nullable, required: Average viewer rating of the show.

## Other responses

- `404`: No such show, or it belongs to another seller.
- `422`: Validation Error

---

[API](https://skmtc.dev/whatnot/apis/whatnot-seller-api.md) - [All operations](https://skmtc.dev/whatnot/apis/whatnot-seller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whatnot/apis/whatnot-seller-api/revisions/e619f15f7ce0?raw)