Depop
Depop Search API
Search Depop listings for sale in one buyer market (us, gb, au, ie, ca, nz, de, fr, it): each listing with its id, slug, title, description, brand, category, condition, sizes, colours, likes, markdown and the price a buyer in that market sees (listing price, original price, buyer fee, tax, shipping, total and Depop's headline price), plus facets with counts per department, brand, colour, condition and size. Depop serves the first 24 results per query, sort and filter set, with no next page: narrow with filters, a price range or a price sort to reach more. Costs 1 credit, 5 on nz.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredSearch keywords, 1-200 characters.
Example: levis 501
countrystringdefault:usThe buyer's market: us, gb, au, ie, ca, nz, de, fr, it (uk accepted for gb). Results and prices are what a buyer in that country sees. Any other value answers 400, not charged.
Example: gb
sortenum<string>default:relevanceResult order. Depop's newest and most-popular orders are not available.
Example: price_asc
relevance— Depop's best match. The default.price_asc— Depop's first 24 for price low to high, in strict listing-price order (other-currency listings last).price_desc— Depop's first 24 for price high to low, in strict listing-price order (other-currency listings last).
brand_idsinteger[] | stringUp to 20 brand ids (brands[].id, items[].brand.id, facets.brands[].id).
Example: [1673]
conditionsstring | string[]brand_new, used_like_new, used_excellent, used_good, used_fair.
Example: ["used_excellent"]
colorsstring | string[]black, blue, brown, burgundy, cream, gold, green, grey, khaki, multi, navy, orange, pink, purple, red, silver, tan, white, yellow.
Example: ["black"]
price_minnumberLowest listing price, in the market's currency.
Example: 20
price_maxnumberHighest listing price, in the market's currency.
Example: 60
on_salebooleanOnly listings the seller marked down (items[].discounted true).
Example: true
genderenum<string>male, female or unisex.
Example: male
sizestring | string[]Size filter values (size_set_id.size_id, from categories with include_sizes, or facets.sizes[].id). Depop honours it only partly.
Example: ["4.15"]
groupstringA group id from categories (tops, bottoms, footwear ...).
Example: bottoms
product_typestring | string[]Product type ids from categories (jeans, hoodies ...).
Example: ["jeans"]
kidsbooleantrue: only kids' listings; false: none.
Example: false
Notes
Markets. country is the buyer's market, one of us, gb, au, ie, ca, nz, de, fr, it (default us; uk is accepted for gb). Results and prices are what a buyer in that country sees: the same listing shows a different buyer fee, tax, shipping and total in each market. Any other country answers 400 before anything is charged.
| country | Market | Market currency | Listing text | Credits |
|---|---|---|---|---|
us | United States (depop.com) | USD | English | 1 |
gb | United Kingdom (uk accepted) | GBP | English | 1 |
au | Australia | AUD | English | 1 |
ie | Ireland | EUR | English | 1 |
ca | Canada | CAD | English | 1 |
nz | New Zealand | NZD | English | 5 |
de | Germany | EUR | Often German | 1 |
fr | France | EUR | Often French | 1 |
it | Italy | EUR | Often Italian | 1 |
Request
from statistics import median
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# What the same search asks in three buyer markets: 1 credit each.
for country in ["us", "gb", "de"]:
data = client.depop.search(query="levis 501", country=country)["data"]
own = [i["price"]["price"] for i in data["items"] if i["buyer_market_price"]]
print(country, data["currency"], len(own), "listings, median", median(own) if own else None)Response