Get shop insights
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.
Request
- Base URLhttps://partnerapi-staging.depop.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Response
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.
Example response
{
"products": {
"on_sale_count": 42,
"total_count": 150
},
"rating": {
"average": 4.8,
"count": 120
},
"boost": {
"live_count": 12,
"sold_count": 34
},
"orders": {
"awaiting_shipping_count": 5
},
"offers": {
"awaiting_seller_review_count": 8
}
}Changes
No recorded changes to this operation across all 1 revision of this API.