Depop Product Search API Documentation Search the Depop marketplace by keyword. Each listing has its id, slug, public url, brand, condition, colours, styles, sizes with stock, description, location, shipping, picture sizes and a full price breakdown with discount percent. The response also holds the total hit count, the applied filters and an opaque cursor for the next page. Sort by price or keep the relevance order. Send the cursor value back as cursor to get the next page. A search with no hits is a successful, billable response with an empty list. For newest first use the search/newest endpoint. The data is public Depop data and the endpoint is read only. A failed request is never billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
18 optional filters available.
string
Required
Search keywords, for example jacket.
coffee shops
string
Optional
Depop market code, two letters, lowercase. List the codes with /api/depop/markets. Defaults to us.
US
integer
Optional
Listings per page, 1 to 200. Defaults to 24.
10
string
Optional
Opaque cursor from data.pagination.next_cursor of the previous page.
0
string
Optional
price_asc or price_desc. Leave out for relevance order.
relevance
string
Optional
Comma separated list. Condition ids such as brand_new, used_like_new, used_excellent, used_good, used_fair.
example
string
Optional
Comma separated list. Brand ids from /api/depop/brands.
example
string
Optional
Comma separated list. Colour ids such as black, blue, burgundy.
example
string
Optional
Comma separated list. Size ids from /api/depop/sizes, for example 2.8.
example
string
Optional
One product group id from /api/depop/categories, for example coats-jackets.
example
string
Optional
Comma separated list. Product type ids from /api/depop/categories.
example
string
Optional
male, female or unisex.
example
boolean
Optional
true for kids items, false for adult items.
true
number
Optional
Lowest price, in the currency of the country.
10
number
Optional
Highest price, in the currency of the country.
10
boolean
Optional
true to return only reduced items.
true
string
Optional
percentage, value or percentage,value. Not every reduced item has a type, so discounted is the complete set.
example
integer
Optional
Lowest discount in percent, 0 to 100.
10
integer
Optional
Highest discount in percent, 0 to 100.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"sort": "price_asc",
"items": [
{
"id": 962025650,
"url": "https://www.depop.com/products/stickerworpdrus-fallout-lucy-trading-card-with-c462/",
"slug": "stickerworpdrus-fallout-lucy-trading-card-with-c462",
"brand": {
"id": 1667,
"name": "Other",
"slug": "unbranded"
},
"group": "art",
"status": "STATUS_ONSALE",
"is_kids": false,
"is_sold": false,
"condition": "brand_new",
"product_type": "stickers",
"active_status": "active",
"category_name": "Art"
},
{
"id": 956025614,
"url": "https://www.depop.com/products/gigie6g-150-per-book-or-any-a000/",
"slug": "gigie6g-150-per-book-or-any-a000",
"brand": {
"id": 1667,
"name": "Other",
"slug": "unbranded"
},
"group": "books-and-magazine",
"status": "STATUS_ONSALE",
"is_kids": false,
"is_sold": false,
"condition": "brand_new",
"product_type": "books",
"active_status": "active",
"category_name": "Books & magazines"
}
],
"query": "jacket",
"country": "us",
"filters": {
"condition": "brand_new"
},
"pagination": {
"has_more": true,
"next_cursor": "MnwzfDE3OTI0NDM3ODA.BOOSTED_EXHAUSTED.0"
},
"total_count": 854828
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. Depop is not called and the request is not billable.
{
"errors": {
"query": [
"A query is required, for example jacket."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Depop did not answer after several tries. Retry later. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Depop API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.