Depop public marketplace API
Read-only access to Depop's public listings, search results, seller shops, and source-provided category, size, and attribute discovery. Listing and shop identifiers are returned by related operations and remain scoped to Depop. Likes, bags, offers, purchases, selling, login, and other state-changing flows are intentionally outside this API.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the Depop public marketplace API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/d8338b88-6782-4f87-8280-fc1aadeb0655/filters/attributes' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETFilters attributes/filters/attributes
Returns Depop's live attribute and product-type metadata used to understand category-specific listing attributes.
Input
No input parameters.
Response
Response fields are not documented yet.
GETFilters brands/filters/brands
Returns Depop's live brand choices. Use a returned numeric id unchanged in the brands parameter of /listings/search; this is the source's complete brand-choice response at retrieval time, not a permanent enum.
Input
No input parameters.
Response
0object0.idinteger0.namestring0.slugstringGETFilters categories/filters/categories
Returns Depop's live department and category hierarchy, including source IDs accepted by listing search.
Input
No input parameters.
Response
departments?object[]departments[].idstringdepartments[].namestringdepartments[].children?unknown[]Fields marked ? are optional.
GETFilters sizes/filters/sizes
Returns Depop's live nested size systems and source composite IDs used to construct size/variant filters.
Input
No input parameters.
Response
0object0.idinteger | string0.namestring0.children?unknown[]0.size_set_id?integer | null0.composite_id?string | nullFields marked ? are optional.
GETListing by id/listings/by-id/{listing_id}
Retrieves the full public listing record by the numeric source ID returned by search or a seller listing collection.
Input
listing_idRequiredPath · integerNumeric Depop listing ID.
Example: 991054945
Response
idintegerslug?string | nullsizes?object[]sizes[].id?integer | nullsizes[].name?string | nullsizes[].status?string | nullsizes[].variant?string | nullsizes[].quantity?integer | nullstatus?string | nullcountry?string | nullpreview?objectpreview.id?integer | nullpreview.formats?objectpreview.is_square?boolean | nullpreview.original_width?integer | nullpreview.original_height?integer | nullpricing?objectpricing.currency?string | nullpricing.campaigns?objectpricing.is_reduced?boolean | nullpricing.currency_name?string | nullpricing.current_price?objectpricing.current_price.total_price?string | nullpricing.current_price.price_breakdown?objectpricing.current_price.price_breakdown.tax?objectpricing.current_price.price_breakdown.tax.amount?string | nullpricing.current_price.price_breakdown.price?objectpricing.current_price.price_breakdown.price.amount?string | nullpricing.current_price.price_breakdown.shipping?objectpricing.current_price.price_breakdown.shipping.amount?string | nullpricing.current_price.price_breakdown.tax_type?string | nullpricing.current_price.price_breakdown.buyer_fee?objectpricing.current_price.price_breakdown.buyer_fee.amount?string | nullpricing.current_price.price_breakdown.shipping_id?string | nullpricing.current_price.price_breakdown.shipping_boundary?string | nullpricing.display_price?objectpricing.display_price.currency?string | nullpricing.display_price.headline_price?objectpricing.display_price.headline_price.amount?string | nullpricing.display_price.headline_price_components?objectpricing.original_price?objectpricing.original_price.total_price?string | nullpricing.original_price.price_breakdown?objectpricing.original_price.price_breakdown.tax?objectpricing.original_price.price_breakdown.tax.amount?string | nullpricing.original_price.price_breakdown.price?objectpricing.original_price.price_breakdown.price.amount?string | nullpricing.original_price.price_breakdown.shipping?objectpricing.original_price.price_breakdown.shipping.amount?string | nullpricing.original_price.price_breakdown.tax_type?string | nullpricing.original_price.price_breakdown.buyer_fee?objectpricing.original_price.price_breakdown.buyer_fee.amount?string | nullpricing.original_price.price_breakdown.shipping_id?string | nullpricing.original_price.price_breakdown.shipping_boundary?string | nullpricing.final_price_key?string | nullpricing.total_price_components?objectuser_id?integer | nullbrand_id?integer | nulllocation?string | nullpictures?object[]pictures[].id?integer | nullpictures[].formats?objectpictures[].is_square?boolean | nullpictures[].original_width?integer | nullpictures[].original_height?integer | nullattributes?objectattributes.brand?string | nullattributes.group?string | nullattributes.colour?string[]attributes.gender?string | nullattributes.is_kids?boolean | nullattributes.condition?string | nullattributes.product_type?string | nullattributes.additional_attributes?objectboosted_at?string | nullbrand_name?string | nullcreated_at?string | nullis_boosted?boolean | nulllike_count?integer | nullupdated_at?string | nulldescription?string | nullvariants_all?object[]variants_all[].id?integer | nullvariants_all[].name?string | nullvariants_all[].status?string | nullvariants_all[].variant?string | nullvariants_all[].quantity?integer | nullactive_status?string | nullcategory_name?string | nullvariant_set_id?integer | nulllisted_quantity?integer | nullshipping_method?objectshipping_method.payer?string | nullshipping_method.ship_from?integer | nullshipping_method.parcel_size?string | nullshipping_method.shipping_id?string | nullFields marked ? are optional.
GETListings search/listings/search
Searches the live Depop marketplace. Results are source-ranked and contain listing records, a source total when provided, and an opaque cursor for the next page. Use /filters/categories and /filters/sizes to discover source identifiers. Multi-value filters are comma-separated source values or repeated parameters.
Input
qOptionalQuery · string, default: Free-text item, brand, or style search. Empty searches browse the current feed.
Example: jeans
cursorOptionalQuery · string, default: Opaque Depop continuation value from page_info.last.
limitOptionalQuery · integer, min: 1, max: 24, default: 24Source records requested; Depop's web client uses at most 24 per page.
Example: 24
countryOptionalQuery · string, default: usTwo-letter Depop market/country code used for result context and shipping pricing.
Example: us
currencyOptionalQuery · string, default: USDCurrency code requested for source pricing.
Example: USD
brandsOptionalQuery · array | nullSource brand IDs, comma-separated or repeated.
Example: 31
groupsOptionalQuery · array | nullSource category-group IDs, comma-separated or repeated.
Example: bottoms
product_typesOptionalQuery · array | nullSource product-type IDs, comma-separated or repeated.
Example: jeans
variantsOptionalQuery · array | nullSource size/variant values or IDs, comma-separated or repeated.
Example: 28
conditionOptionalQuery · array | nullSource condition values, comma-separated or repeated.
Example: used_like_new
coloursOptionalQuery · array | nullSource colour values, comma-separated or repeated.
Example: blue
genderOptionalQuery · string | nullSource gender filter value.
Example: female
is_kidsOptionalQuery · boolean | nullSource kids/non-kids classification.
Example: true
discountedOptionalQuery · boolean | nullWhen true, request Depop's discounted listings subset.
Example: true
price_minOptionalQuery · number | string | nullLower source price boundary in the requested currency.
Example: 10
price_maxOptionalQuery · number | string | nullUpper source price boundary in the requested currency.
Example: 50
rankingOptionalQuery · string | nullDepop ranking/sort value from the selected source surface.
Example: relevance
user_idOptionalQuery · integer | nullRestrict results to a source seller ID returned by a listing or shop operation.
Example: 218231053
Response
meta?objectmeta.total_count?integer | nullobjects?object[]objects[].idintegerobjects[].slug?string | nullobjects[].sizes?object[]objects[].sizes[].id?integer | nullobjects[].sizes[].name?string | nullobjects[].sizes[].status?string | nullobjects[].sizes[].variant?string | nullobjects[].sizes[].quantity?integer | nullobjects[].status?string | nullobjects[].country?string | nullobjects[].preview?objectobjects[].preview.id?integer | nullobjects[].preview.formats?objectobjects[].preview.is_square?boolean | nullobjects[].preview.original_width?integer | nullobjects[].preview.original_height?integer | nullobjects[].pricing?objectobjects[].pricing.currency?string | nullobjects[].pricing.campaigns?objectobjects[].pricing.is_reduced?boolean | nullobjects[].pricing.currency_name?string | nullobjects[].pricing.current_price?objectobjects[].pricing.current_price.total_price?string | nullobjects[].pricing.current_price.price_breakdown?objectobjects[].pricing.current_price.price_breakdown.tax?objectobjects[].pricing.current_price.price_breakdown.tax.amount?string | nullobjects[].pricing.current_price.price_breakdown.price?objectobjects[].pricing.current_price.price_breakdown.price.amount?string | nullobjects[].pricing.current_price.price_breakdown.shipping?objectobjects[].pricing.current_price.price_breakdown.shipping.amount?string | nullobjects[].pricing.current_price.price_breakdown.tax_type?string | nullobjects[].pricing.current_price.price_breakdown.buyer_fee?objectobjects[].pricing.current_price.price_breakdown.buyer_fee.amount?string | nullobjects[].pricing.current_price.price_breakdown.shipping_id?string | nullobjects[].pricing.current_price.price_breakdown.shipping_boundary?string | nullobjects[].pricing.display_price?objectobjects[].pricing.display_price.currency?string | nullobjects[].pricing.display_price.headline_price?objectobjects[].pricing.display_price.headline_price.amount?string | nullobjects[].pricing.display_price.headline_price_components?objectobjects[].pricing.original_price?objectobjects[].pricing.original_price.total_price?string | nullobjects[].pricing.original_price.price_breakdown?objectobjects[].pricing.original_price.price_breakdown.tax?objectobjects[].pricing.original_price.price_breakdown.tax.amount?string | nullobjects[].pricing.original_price.price_breakdown.price?objectobjects[].pricing.original_price.price_breakdown.price.amount?string | nullobjects[].pricing.original_price.price_breakdown.shipping?objectobjects[].pricing.original_price.price_breakdown.shipping.amount?string | nullobjects[].pricing.original_price.price_breakdown.tax_type?string | nullobjects[].pricing.original_price.price_breakdown.buyer_fee?objectobjects[].pricing.original_price.price_breakdown.buyer_fee.amount?string | nullobjects[].pricing.original_price.price_breakdown.shipping_id?string | nullobjects[].pricing.original_price.price_breakdown.shipping_boundary?string | nullobjects[].pricing.final_price_key?string | nullobjects[].pricing.total_price_components?objectobjects[].user_id?integer | nullobjects[].brand_id?integer | nullobjects[].location?string | nullobjects[].pictures?object[]objects[].pictures[].id?integer | nullobjects[].pictures[].formats?objectobjects[].pictures[].is_square?boolean | nullobjects[].pictures[].original_width?integer | nullobjects[].pictures[].original_height?integer | nullobjects[].attributes?objectobjects[].attributes.brand?string | nullobjects[].attributes.group?string | nullobjects[].attributes.colour?string[]objects[].attributes.gender?string | nullobjects[].attributes.is_kids?boolean | nullobjects[].attributes.condition?string | nullobjects[].attributes.product_type?string | nullobjects[].attributes.additional_attributes?objectobjects[].boosted_at?string | nullobjects[].brand_name?string | nullobjects[].created_at?string | nullobjects[].is_boosted?boolean | nullobjects[].like_count?integer | nullobjects[].updated_at?string | nullobjects[].description?string | nullobjects[].variants_all?object[]objects[].variants_all[].id?integer | nullobjects[].variants_all[].name?string | nullobjects[].variants_all[].status?string | nullobjects[].variants_all[].variant?string | nullobjects[].variants_all[].quantity?integer | nullobjects[].active_status?string | nullobjects[].category_name?string | nullobjects[].variant_set_id?integer | nullobjects[].listed_quantity?integer | nullobjects[].shipping_method?objectobjects[].shipping_method.payer?string | nullobjects[].shipping_method.ship_from?integer | nullobjects[].shipping_method.parcel_size?string | nullobjects[].shipping_method.shipping_id?string | nullpage_info?objectpage_info.last?string | nullpage_info.has_more?boolean, default: falseFields marked ? are optional.
For the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.
GETShop by username/shops/by-username/{username}
Resolves a Depop username to the public seller profile and numeric shop ID needed by related operations.
Input
usernameRequiredPath · stringDepop username without the @ prefix.
Example: carmen_0239
Response
idintegerbio?string | nullpicture?objectwebsite?string | nullinitials?string | nullusername?string | nullverified?boolean | nullfollowers?integer | nullfollowing?integer | nulllast_name?string | nulllast_seen?string | nullfirst_name?string | nullitems_sold?integer | nullbuyer_ratings?integer | nullreviews_total?integer | nullreviews_rating?number | nullseller_ratings?integer | nullFields marked ? are optional.
GETShop by id/shops/{shop_id}
Returns the public seller profile and seller metrics for a numeric shop ID returned by a listing or shop lookup.
Input
shop_idRequiredPath · integerNumeric Depop shop ID.
Example: 218231053
Response
idintegerbio?string | nullpicture?objectwebsite?string | nullinitials?string | nullusername?string | nullverified?boolean | nullfollowers?integer | nullfollowing?integer | nulllast_name?string | nulllast_seen?string | nullfirst_name?string | nullitems_sold?integer | nullbuyer_ratings?integer | nullreviews_total?integer | nullreviews_rating?number | nullseller_ratings?integer | nullFields marked ? are optional.
GETShop listings/shops/{shop_id}/listings
Returns the seller's live public listing collection with the source cursor for continuation.
Input
shop_idRequiredPath · integerNumeric Depop shop ID.
Example: 218231053
cursorOptionalQuery · string, default: Opaque Depop continuation value from page_info.last.
limitOptionalQuery · integer, min: 1, max: 24, default: 24Source records requested; Depop's web client uses at most 24 per page.
Example: 24
Response
meta?objectmeta.total_count?integer | nullobjects?object[]objects[].idintegerobjects[].slug?string | nullobjects[].sizes?object[]objects[].sizes[].id?integer | nullobjects[].sizes[].name?string | nullobjects[].sizes[].status?string | nullobjects[].sizes[].variant?string | nullobjects[].sizes[].quantity?integer | nullobjects[].status?string | nullobjects[].country?string | nullobjects[].preview?objectobjects[].preview.id?integer | nullobjects[].preview.formats?objectobjects[].preview.is_square?boolean | nullobjects[].preview.original_width?integer | nullobjects[].preview.original_height?integer | nullobjects[].pricing?objectobjects[].pricing.currency?string | nullobjects[].pricing.campaigns?objectobjects[].pricing.is_reduced?boolean | nullobjects[].pricing.currency_name?string | nullobjects[].pricing.current_price?objectobjects[].pricing.current_price.total_price?string | nullobjects[].pricing.current_price.price_breakdown?objectobjects[].pricing.current_price.price_breakdown.tax?objectobjects[].pricing.current_price.price_breakdown.tax.amount?string | nullobjects[].pricing.current_price.price_breakdown.price?objectobjects[].pricing.current_price.price_breakdown.price.amount?string | nullobjects[].pricing.current_price.price_breakdown.shipping?objectobjects[].pricing.current_price.price_breakdown.shipping.amount?string | nullobjects[].pricing.current_price.price_breakdown.tax_type?string | nullobjects[].pricing.current_price.price_breakdown.buyer_fee?objectobjects[].pricing.current_price.price_breakdown.buyer_fee.amount?string | nullobjects[].pricing.current_price.price_breakdown.shipping_id?string | nullobjects[].pricing.current_price.price_breakdown.shipping_boundary?string | nullobjects[].pricing.display_price?objectobjects[].pricing.display_price.currency?string | nullobjects[].pricing.display_price.headline_price?objectobjects[].pricing.display_price.headline_price.amount?string | nullobjects[].pricing.display_price.headline_price_components?objectobjects[].pricing.original_price?objectobjects[].pricing.original_price.total_price?string | nullobjects[].pricing.original_price.price_breakdown?objectobjects[].pricing.original_price.price_breakdown.tax?objectobjects[].pricing.original_price.price_breakdown.tax.amount?string | nullobjects[].pricing.original_price.price_breakdown.price?objectobjects[].pricing.original_price.price_breakdown.price.amount?string | nullobjects[].pricing.original_price.price_breakdown.shipping?objectobjects[].pricing.original_price.price_breakdown.shipping.amount?string | nullobjects[].pricing.original_price.price_breakdown.tax_type?string | nullobjects[].pricing.original_price.price_breakdown.buyer_fee?objectobjects[].pricing.original_price.price_breakdown.buyer_fee.amount?string | nullobjects[].pricing.original_price.price_breakdown.shipping_id?string | nullobjects[].pricing.original_price.price_breakdown.shipping_boundary?string | nullobjects[].pricing.final_price_key?string | nullobjects[].pricing.total_price_components?objectobjects[].user_id?integer | nullobjects[].brand_id?integer | nullobjects[].location?string | nullobjects[].pictures?object[]objects[].pictures[].id?integer | nullobjects[].pictures[].formats?objectobjects[].pictures[].is_square?boolean | nullobjects[].pictures[].original_width?integer | nullobjects[].pictures[].original_height?integer | nullobjects[].attributes?objectobjects[].attributes.brand?string | nullobjects[].attributes.group?string | nullobjects[].attributes.colour?string[]objects[].attributes.gender?string | nullobjects[].attributes.is_kids?boolean | nullobjects[].attributes.condition?string | nullobjects[].attributes.product_type?string | nullobjects[].attributes.additional_attributes?objectobjects[].boosted_at?string | nullobjects[].brand_name?string | nullobjects[].created_at?string | nullobjects[].is_boosted?boolean | nullobjects[].like_count?integer | nullobjects[].updated_at?string | nullobjects[].description?string | nullobjects[].variants_all?object[]objects[].variants_all[].id?integer | nullobjects[].variants_all[].name?string | nullobjects[].variants_all[].status?string | nullobjects[].variants_all[].variant?string | nullobjects[].variants_all[].quantity?integer | nullobjects[].active_status?string | nullobjects[].category_name?string | nullobjects[].variant_set_id?integer | nullobjects[].listed_quantity?integer | nullobjects[].shipping_method?objectobjects[].shipping_method.payer?string | nullobjects[].shipping_method.ship_from?integer | nullobjects[].shipping_method.parcel_size?string | nullobjects[].shipping_method.shipping_id?string | nullpage_info?objectpage_info.last?string | nullpage_info.has_more?boolean, default: falseFields marked ? are optional.
For the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.