Depop product search
Items for sale on Depop for a keyword, with every filter of the site's search: brands (slugs or ids), sizes, condition, colours, price range, gender, kids, department group and product type, on-sale items, and sort by relevance or price. Each item: id, slug, url, description, brand, category, status, sold, price, original_price, total_price, currency, on_sale, shipping_price, sizes, size_set_id, condition, colours, gender, group, product_type, location, country, like_count, image, images and raw. total is the site's count. Pass next_cursor back as cursor; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Depop API: 11 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
q | string | Keywords, e.g. nike hoodie. Example: levis jeans |
country | us | gb | au | ie | fr | de | it | nz | ca | Depop market: us (default, USD), gb (GBP), au, ie, fr, de, it, nz, ca. Sets the shop country and the price currency. |
brands | string | Brand slugs (from /depop/v1/brands, e.g. nike, levi-s) or brand ids, comma separated. |
sizes | string | Size ids <size set>.<size> (from /depop/v1/sizes or an item's size_set_id and raw.sizes[].id), comma separated, e.g. 54.5. |
condition | string | brand_new, used_like_new, used_excellent, used_good, used_fair, comma separated. |
colours | string | Colours, comma separated, e.g. black,blue. |
price_min | string | Lowest price in the market currency. |
price_max | string | Highest price in the market currency. |
gender | male | female | unisex | Department. |
is_kids | true | false | true: kids' items only; false: no kids' items. |
groups | string | Category groups from /depop/v1/categories (e.g. tops, bottoms, footwear), comma separated. |
product_types | string | Product types from /depop/v1/categories (e.g. tshirts, jeans), comma separated. |
on_sale | true | false | true: discounted items only. |
seller_id | string | Search inside one shop (its numeric id, id from /depop/v1/shop). |
sort | relevance | price_low | price_high | Order (default relevance). |
limit | string | Items per page, 1-100 (default 24). |
cursor | string | next_cursor from the previous page. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/depop/v1/search?q=levis+jeans" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/depop/v1/search",
params={"q": "levis jeans"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/depop/v1/search");
url.searchParams.set("q", "levis jeans");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"q": "levis jeans","country": "us","currency": "USD","applied_filters": {},"total": 790597,"count": 24,"next_cursor": "MnwyNHwxNzkzNzg2MTM3.BOOSTED_EXHAUSTED.0","items": [{"id": 983838032,"slug": "agrobinette-brand-new-levis-straught-leg-82b4","url": "https://www.depop.com/products/agrobinette-brand-new-levis-straught-leg-82b4/","description": "brand new levi’s straught leg jeans #denim #levis #jeans","brand": "Levi's","brand_id": 31,"category": "Bottoms","categories": null,"status": "STATUS_ONSALE","sold": false,"price": 21,"original_price": 21,"total_price": 21,"currency": "USD","on_sale": false,"shipping_price": 5.99,"buyer_fee": 0,"sizes": ["4"],"size_set_id": 22,"condition": "brand_new","colours": ["navy","blue"],"gender": "female","group": "bottoms","product_type": "jeans","location": "Elizabethton, United States","country": "US","seller_id": null,"quantity": 1,"boosted": false,"like_count": 0,"created_at": null,"updated_at": null,"image": "https://media-photos.depop.com/r1/388076238/5121594996_ecdb5d20ebb74313aaf7ecbd18b58a6e/P0.jpg","images": ["https://media-photos.depop.com/r1/388076238/5121594996_ecdb5d20ebb74313aaf7ecbd18b58a6e/P0.jpg","https://media-photos.depop.com/r1/388076238/5121594897_55efe8962cd449ca875cf8c4b0bd9aeb/P0.jpg","… 6 more"]},{"id": 983776336,"slug": "sra7wad232-levis-505-refular-fit-black-73e3","url": "https://www.depop.com/products/sra7wad232-levis-505-refular-fit-black-73e3/","description": "Levi's 505 refular fit black jeans size 34 #denim #classic #levi #jeans #levis","brand": "Levi's","brand_id": 31,"category": "Jeans","categories": null,"status": "STATUS_ONSALE","sold": false,"price": 27,"original_price": 27,"total_price": 27,"currency": "USD","on_sale": false,"shipping_price": 5.99,"buyer_fee": 0,"sizes": ["34\""],"size_set_id": 60,"condition": "used_like_new","colours": ["black","grey"],"gender": "male","group": "bottoms","product_type": "jeans","location": "Big Rapids, United States","country": "US","seller_id": null,"quantity": 1,"boosted": false,"like_count": 0,"created_at": null,"updated_at": null,"image": "https://media-photos.depop.com/r1/235754755/5121217210_eba365d87c494f5db69a95ba652cd7a8/P0.jpg","images": ["https://media-photos.depop.com/r1/235754755/5121217210_eba365d87c494f5db69a95ba652cd7a8/P0.jpg","https://media-photos.depop.com/r1/235754755/5121218737_889e827c0c5740bcae7593079b133752/P0.jpg","… 2 more"]},"… 22 more"],"cached": false,"credits_used": 1}