Depop
Depop Category API
The first 24 Depop listings of one category in a buyer market (us, gb, au, ie, ca, nz, de, fr, it), by the category path from categories: department, then group, then product type (mens/bottoms/jeans, womens/tops, kids). Each listing carries the same fields as search, with the price a buyer in that market sees; sorted by relevance or price and filtered by brand, condition, colour, size, price range or markdown. Depop serves no next page: narrow with filters 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/jsoncategorystring | string[]requiredCategory path from categories: department[/group[/product_type]], department one of mens, womens, kids, everything-else. A list of up to 3 parts works too.
Example: mens/bottoms/jeans
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"]
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 scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# The cheapest 24 men's jeans in like-new condition, for a UK buyer.
data = client.depop.category(category="mens/bottoms/jeans", country="gb", conditions=["used_like_new"], sort="price_asc")["data"]
for i in data["items"]:
print(i["price"]["currency"], i["price"]["price"], i["price"]["total"], i["title"])Response