---
title: "Get shop insights"
method: GET
path: "/api/v1/insights/shop/live/"
tags: ["Insights"]
---

# Get shop insights

`GET /api/v1/insights/shop/live/`

## Request

- Base URL: `https://partnerapi-staging.depop.com`
- URL: `https://partnerapi-staging.depop.com/api/v1/insights/shop/live/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/depop/apis/seller-api/docs/api/v1/insights/shop/live/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns insights about the authenticated seller's shop, including product counts, shop rating, offers awaiting review, boost ad counts and orders awaiting shipping.

**Required OAuth Scopes:** at least one of the scopes below. Each section of the response is included only when its corresponding scope is present, and omitted otherwise. A `403` is returned only when none of these scopes are present.
- `products_read` - Include product counts (`products`) and boost ad counts (`boost`). - `shop_read` - Include shop rating (`rating`). - `offers_read` - Include offers awaiting seller review (`offers`). - `orders_read` - Include orders awaiting shipping (`orders`).

A section is included in the response only when its corresponding scope is present, and is omitted entirely otherwise. A `403` is returned only when the token has none of the four scopes above.
**Note:** Counters may be delayed by up to 60 minutes and may not reflect the most recent changes to your shop inventory.

## Response `200`

Shop insights. Each section is present only when the token holds the scope that section requires; sections for missing scopes are omitted. The `orders` section is additionally omitted when there are no orders awaiting shipping.

- ShopInsightsResponse: Insights for the authenticated seller's shop. Counters may be delayed by up to 60 minutes.
  - `products` ShopProductsInsights: Product count insights for the shop.
    - `on_sale_count` integer, required: Number of products currently on sale.
    - `total_count` integer, required: Total number of products in the shop.
  - `rating` ShopRatingInsights: Seller rating insights for the shop.
    - `average` number, double, required: Average seller rating across all reviews.
    - `count` integer, required: Number of seller reviews received.
  - `boost` ShopBoostInsights: Boosted listings (ads) insights for the shop.
    - `live_count` integer, required: Number of boosted listings currently live.
    - `sold_count` integer, required: Number of boosted listings that have sold.
  - `orders` ShopOrdersInsights: Order insights for the shop.
    - `awaiting_shipping_count` integer, required: Count of orders awaiting shipping. Counts orders whose receipt is within the recent cut-off window and that have not been refunded. Capped at 20.
  - `offers` ShopOffersInsights: Offer insights for the shop.
    - `awaiting_seller_review_count` integer, required: Number of offers across the shop awaiting the seller's review.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Insufficient scope
- `429`: Too Many Requests - the rate limit for a shop or seller, or the overall limit for your integration, has been exceeded.
- `502`: Bad Gateway - an upstream service required to build the insights response failed or returned an unexpected response.

---

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