---
title: "Get pricing inspiration when given product listing details"
method: POST
path: "/api/v1/pricing/inspiration/"
tags: ["Pricing Inspiration"]
---

# Get pricing inspiration when given product listing details

`POST /api/v1/pricing/inspiration/`

## Request

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

This endpoint returns a price prediction range and a list of similar sold items for a product listing.
The price prediction is the core of the response. The list of similar sold items is supplementary and best-effort: if the similar sold items lookup is unavailable (for example, a timeout), the endpoint still returns the price prediction with an empty `similar_sold_items` array rather than failing. Clients should therefore not rely on `similar_sold_items` always being populated.
This endpoint does not require OAuth Scopes and is only valid for specific countries (US and GB).

## Request body

- PricingInspirationRequest
  - `description` string, required: A detailed description of the product. The more detail the better the prediction
  - `country` string, required: The country the product is listed in.
  - `currency` string, required: The currency code for the listing.
  - `product_type` string, required: The type of product. Find out more in the taxonomy section of the API docs.
  - `department` string, required: The product department. Find out more in the taxonomy section of the API docs.
  - `condition` string, required: The condition of the product. Find out more in the taxonomy section of the API docs.
  - `brand_name` string, required: The canonical brand name of the product.
  - `size_set_id` integer: The size set ID for the given Department and Product Type.
  - `size_id` integer: The size identifier.
  - `colour` string[]: List of colours for the product.
  - `style` string[]: List of styles for the product.
  - `source` string[]

## Response `200`

OK

- PricingInspirationResponse
  - `price_prediction` PricePrediction, required: The price prediction range with the predicted balanced sale price and a higher and lower bound price.
    - `balanced` string: The balanced price for the product.
    - `prediction` string: The predicted price for the product. Deprecated - use 'balanced' instead.
    - `upper_bound` string: The upper bound of the predicted price range.
    - `lower_bound` string: The lower bound of the predicted price range.
  - `similar_sold_items` SimilarSoldItem[], required: A best-effort list of similar sold items. May be empty if no comparable items are found, or if the similar sold items lookup is temporarily unavailable. The price prediction is still returned in either case.
    - `picture` Picture
      - `url` string, required: URL of the picture.
      - `height` number, required
      - `width` number, required
    - `sold_price_amount` string: The sale price of the item.
    - `sold_price_currency` string: The currency of the sale price.
    - `condition` 'brand_new' | 'used_like_new' | 'used_excellent' | 'used_good' | 'used_fair': The condition of the sold item.
    - `brand_name` string: The canonical brand name of the product.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not Found - no price prediction is available for the given attributes (for example, an uncommon brand and product type combination).
- `422`: Unprocessable Entity - validation error
- `500`: Internal Server Error

---

[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)