Depop shop API

Endpoint facts

Method

GET

API path

/depop/shop/{username}

Auth

apiKey

Credits

3 credits/request

Charged on

Successful 2xx responses only

Platform

Depop

Execution

Managed browser rendering where the target needs it

Response schema

#/definitions/depop.shopResponseDoc

How this endpoint behaves

Path parameters:

• username (required) — the seller's URL slug, e.g. villafanashop from depop.com/villafanashop/.

Query parameters:

• price_min (optional) — minimum listing price in USD.
• price_max (optional) — maximum listing price in USD. Must not be less than price_min when both are set.
• condition (optional) — comma-separated condition filter. Allowed values: brand_new, used_like_new, used_excellent, used_good, used_fair.
• colours (optional) — comma-separated colour filter. Allowed values: black, grey, white, brown, tan, cream, yellow, red, burgundy, orange, pink, purple, blue, navy, green, khaki, multi, silver, gold.
• on_sale (optional) — true to restrict results to discounted listings.
• sort (optional) — sort order. Allowed values: relevance (default when omitted), price_low_to_high, price_high_to_low, recently_listed.
• category (optional) — a Depop category slug. Allowed values: tops, bottoms, dresses, coats-jackets, jumpsuit-and-playsuit, suits, footwear, accessories, nightwear, underwear, swim-beach-wear, fancy-dress, sleepsuits-and-bodysuits, bundles, beauty, face-masks, home, tech-accessories, film, art, books-and-magazine, music, party-supplies, sports-equipment-accesories, toys, umbrella. See GET /depop/categories for a machine-readable enumeration with names and subcategories.
• subcategory (optional) — comma-separated Depop subcategory slug(s) (e.g. tshirts, hoodies), scoped within category. See GET /depop/categories for the full enumerated list per category. Not independently validated against category here — an unrecognized or mismatched slug returns zero results rather than an error.
• gender (optional) — department filter. Allowed values: female, male.
• sizes (optional) — comma-separated Depop size composite ids, format {size_set_id}.{id} (e.g. 54.4). Not a closed enum this endpoint can validate — only format-checked. See GET /depop/sizes for the full multi-region taxonomy each id resolves to.

Notable response behavior:

• This endpoint parses the shop page's rendered HTML, not a JSON API (none was found for per-seller listings) — so each item in items is a lighter shape than /depop/search's: no brand, condition, colour, description, or size, since the shop page doesn't render those per card. id is the item's URL slug, same identifier space as /depop/search's id and /depop/item/{slug}'s slug — chain any item into /depop/item/{slug} for full detail.
• followers_count and following_count are approximate once Depop abbreviates them in the UI (e.g. "2.35K" → 2350) — Depop doesn't render the exact count past a certain size.
• currency is always "USD" — inferred from the $ symbol the page renders, not read from an explicit field (unlike /depop/search and /depop/item/{slug}, which get an explicit currency code from Depop's own JSON).
• A shop with no current listings returns 200 with "items": [].
• If Depop reports current listings but the page's product cards cannot be parsed, the endpoint returns an upstream error instead of an empty listing.
• An empty or malformed username returns 400 before any upstream request is made. An unrecognized condition, colours, sort, category, or gender value, a malformed subcategory or sizes entry, or price_min greater than price_max, also returns 400.
• A nonexistent username returns 404.

Live monitoring

Monitored request

GET /depop/shop/vintagelistings

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

10.46 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /depop/shop/vintagelistings

Fields returned with a value

10

Fields returned empty

1

Shared guides

Related