---
title: "Shop Details"
method: POST
path: "/shop_details"
tags: ["Market Data"]
---

# Shop Details

`POST /shop_details`

## Request

- Base URL: `https://external-api.wine-labs.com`
- URL: `https://external-api.wine-labs.com/shop_details`
- Auth: none declared

Retrieve detailed information about a retailer/shop by ID, or search for shops by name.

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier used for authentication and rate limiting.
  - `retailer_id` number: The retailer ID to look up. Required when not using search mode.
  - `query` string: Search query for shop names (minimum 3 characters). When provided, activates search mode.
  - `limit` number: Maximum results returned in search mode.
  - `offset` number: Pagination offset for search mode.

## Response `200`

Response highlights:
- `retailer_id`: unique retailer identifier.
- `shop_type`: type of shop (merchant, grocery, wine_shop).
- `shop_name`: name of the shop/retailer.
- `shop_country`: country where the shop is located.
- `shop_state`: state/region where the shop is located.
- `offers_count`: number of wine offers available from this retailer.
- `shop_price_rating`: price competitiveness rating (higher = better prices).
- `shop_diversity_rating`: inventory diversity rating (higher = more diverse selection).
- In search mode: returns `results[]` array of shop details.

Notes:
- Either `retailer_id` or `query` must be provided.

- object

---

[API](https://skmtc.dev/winelabs/apis/wine-labs-api.md) · [All operations](https://skmtc.dev/winelabs/apis/wine-labs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winelabs/apis/wine-labs-api/revisions/f8898ca9974e?raw)