Skip to main content

Query Parameters

query
string
required
Free-text search query, e.g. nike air max, vintage levis, carhartt jacket.
market
string
default:"us"
Which market to search. Depop runs on a single global host (www.depop.com) localised by market — this selects the country and currency of the results. See /v1/depop/markets for the full list.
per_page
integer
default:24
Number of items per page. Range: 1 - 24.
page
integer
default:1
Page number for paginated results (page-based pagination).
price_min
number
Minimum price in the market’s local currency.
price_max
number
Maximum price in the market’s local currency.
brands
string
Comma-separated brand filters, e.g. nike,adidas.
sizes
string
Comma-separated size filters, e.g. m,l or uk-10.
colours
string
Comma-separated colour filters, e.g. black,green.
conditions
string
Comma-separated condition filters, e.g. brand_new,used_excellent.
gender
string
Gender department filter, e.g. menswear, womenswear.
sort
string
Result ordering, e.g. relevance (default), newlyListed, priceAscending, priceDescending.

Response

products
array
Array of matching item cards.
meta
object
Pagination info.
market
string
The market that was searched.
query
string
The query that was searched.

Example Response

{
  "products": [
    {
      "slug": "seller123-nike-air-max-90-uk-9",
      "url": "https://www.depop.com/products/seller123-nike-air-max-90-uk-9/",
      "seller_username": "seller123",
      "brand": "Nike",
      "size": "UK 9",
      "price": 65.0,
      "original_price": 90.0,
      "currency": "USD",
      "is_sold": false,
      "image": "https://media-photos.depop.com/b1/12345/photo.jpg"
    }
  ],
  "meta": {
    "result_count": 24,
    "page": 1,
    "has_more": true
  },
  "market": "us",
  "query": "nike air max"
}
Each search request costs 10 credits. Failed requests are not charged.