Depop
Depop Brand API
The first 24 Depop listings of one brand in a buyer market (us, gb, au, ie, ca, nz, de, fr, it), by the brand slug from brands (carhartt, levi-s, nike): the brand's id and name and each listing with the same fields as search and the price a buyer in that market sees. Sorted by relevance or price and filtered by condition, colour, size, price range, markdown, gender, group or product type. 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/jsonslugstringrequiredBrand slug (brands[].slug, items[].brand.slug), e.g. carhartt, levi-s, nike.
Example: carhartt
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).
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 scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# Marked-down Carhartt jackets in the US, cheapest first.
data = client.depop.brand(slug="carhartt", country="us", product_type=["jackets"], on_sale=True, sort="price_asc")["data"]
for i in data["items"]:
print(i["price"]["original_price"], "->", i["price"]["price"], f'{i["discount_percentage"]}%', i["title"])Response