Catalog / Depop public marketplace

Depop public marketplace API

depop.com

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.

  • shopping
  • depop
  • marketplace
  • fashion
  • listings
9 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

Returns Depop's live attribute and product-type metadata used to understand category-specific listing attributes.

View call pricing
cURL · Filters attributes
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

0object
0.idinteger
0.namestring
0.slugstring
GETFilters 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[].idstring
departments[].namestring
departments[].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

0object
0.idinteger | string
0.namestring
0.children?unknown[]
0.size_set_id?integer | null
0.composite_id?string | null

Fields 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 · integer

Numeric Depop listing ID.

Example: 991054945

Response

idinteger
slug?string | null
sizes?object[]
sizes[].id?integer | null
sizes[].name?string | null
sizes[].status?string | null
sizes[].variant?string | null
sizes[].quantity?integer | null
status?string | null
country?string | null
preview?object
preview.id?integer | null
preview.formats?object
preview.is_square?boolean | null
preview.original_width?integer | null
preview.original_height?integer | null
pricing?object
pricing.currency?string | null
pricing.campaigns?object
pricing.is_reduced?boolean | null
pricing.currency_name?string | null
pricing.current_price?object
pricing.current_price.total_price?string | null
pricing.current_price.price_breakdown?object
pricing.current_price.price_breakdown.tax?object
pricing.current_price.price_breakdown.tax.amount?string | null
pricing.current_price.price_breakdown.price?object
pricing.current_price.price_breakdown.price.amount?string | null
pricing.current_price.price_breakdown.shipping?object
pricing.current_price.price_breakdown.shipping.amount?string | null
pricing.current_price.price_breakdown.tax_type?string | null
pricing.current_price.price_breakdown.buyer_fee?object
pricing.current_price.price_breakdown.buyer_fee.amount?string | null
pricing.current_price.price_breakdown.shipping_id?string | null
pricing.current_price.price_breakdown.shipping_boundary?string | null
pricing.display_price?object
pricing.display_price.currency?string | null
pricing.display_price.headline_price?object
pricing.display_price.headline_price.amount?string | null
pricing.display_price.headline_price_components?object
pricing.original_price?object
pricing.original_price.total_price?string | null
pricing.original_price.price_breakdown?object
pricing.original_price.price_breakdown.tax?object
pricing.original_price.price_breakdown.tax.amount?string | null
pricing.original_price.price_breakdown.price?object
pricing.original_price.price_breakdown.price.amount?string | null
pricing.original_price.price_breakdown.shipping?object
pricing.original_price.price_breakdown.shipping.amount?string | null
pricing.original_price.price_breakdown.tax_type?string | null
pricing.original_price.price_breakdown.buyer_fee?object
pricing.original_price.price_breakdown.buyer_fee.amount?string | null
pricing.original_price.price_breakdown.shipping_id?string | null
pricing.original_price.price_breakdown.shipping_boundary?string | null
pricing.final_price_key?string | null
pricing.total_price_components?object
user_id?integer | null
brand_id?integer | null
location?string | null
pictures?object[]
pictures[].id?integer | null
pictures[].formats?object
pictures[].is_square?boolean | null
pictures[].original_width?integer | null
pictures[].original_height?integer | null
attributes?object
attributes.brand?string | null
attributes.group?string | null
attributes.colour?string[]
attributes.gender?string | null
attributes.is_kids?boolean | null
attributes.condition?string | null
attributes.product_type?string | null
attributes.additional_attributes?object
boosted_at?string | null
brand_name?string | null
created_at?string | null
is_boosted?boolean | null
like_count?integer | null
updated_at?string | null
description?string | null
variants_all?object[]
variants_all[].id?integer | null
variants_all[].name?string | null
variants_all[].status?string | null
variants_all[].variant?string | null
variants_all[].quantity?integer | null
active_status?string | null
category_name?string | null
variant_set_id?integer | null
listed_quantity?integer | null
shipping_method?object
shipping_method.payer?string | null
shipping_method.ship_from?integer | null
shipping_method.parcel_size?string | null
shipping_method.shipping_id?string | null

Fields marked ? are optional.

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 · string

Depop username without the @ prefix.

Example: carmen_0239

Response

idinteger
bio?string | null
picture?object
website?string | null
initials?string | null
username?string | null
verified?boolean | null
followers?integer | null
following?integer | null
last_name?string | null
last_seen?string | null
first_name?string | null
items_sold?integer | null
buyer_ratings?integer | null
reviews_total?integer | null
reviews_rating?number | null
seller_ratings?integer | null

Fields 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 · integer

Numeric Depop shop ID.

Example: 218231053

Response

idinteger
bio?string | null
picture?object
website?string | null
initials?string | null
username?string | null
verified?boolean | null
followers?integer | null
following?integer | null
last_name?string | null
last_seen?string | null
first_name?string | null
items_sold?integer | null
buyer_ratings?integer | null
reviews_total?integer | null
reviews_rating?number | null
seller_ratings?integer | null

Fields 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 · integer

Numeric Depop shop ID.

Example: 218231053

cursorOptionalQuery · string, default:

Opaque Depop continuation value from page_info.last.

limitOptionalQuery · integer, min: 1, max: 24, default: 24

Source records requested; Depop's web client uses at most 24 per page.

Example: 24

Response

meta?object
meta.total_count?integer | null
objects?object[]
objects[].idinteger
objects[].slug?string | null
objects[].sizes?object[]
objects[].sizes[].id?integer | null
objects[].sizes[].name?string | null
objects[].sizes[].status?string | null
objects[].sizes[].variant?string | null
objects[].sizes[].quantity?integer | null
objects[].status?string | null
objects[].country?string | null
objects[].preview?object
objects[].preview.id?integer | null
objects[].preview.formats?object
objects[].preview.is_square?boolean | null
objects[].preview.original_width?integer | null
objects[].preview.original_height?integer | null
objects[].pricing?object
objects[].pricing.currency?string | null
objects[].pricing.campaigns?object
objects[].pricing.is_reduced?boolean | null
objects[].pricing.currency_name?string | null
objects[].pricing.current_price?object
objects[].pricing.current_price.total_price?string | null
objects[].pricing.current_price.price_breakdown?object
objects[].pricing.current_price.price_breakdown.tax?object
objects[].pricing.current_price.price_breakdown.tax.amount?string | null
objects[].pricing.current_price.price_breakdown.price?object
objects[].pricing.current_price.price_breakdown.price.amount?string | null
objects[].pricing.current_price.price_breakdown.shipping?object
objects[].pricing.current_price.price_breakdown.shipping.amount?string | null
objects[].pricing.current_price.price_breakdown.tax_type?string | null
objects[].pricing.current_price.price_breakdown.buyer_fee?object
objects[].pricing.current_price.price_breakdown.buyer_fee.amount?string | null
objects[].pricing.current_price.price_breakdown.shipping_id?string | null
objects[].pricing.current_price.price_breakdown.shipping_boundary?string | null
objects[].pricing.display_price?object
objects[].pricing.display_price.currency?string | null
objects[].pricing.display_price.headline_price?object
objects[].pricing.display_price.headline_price.amount?string | null
objects[].pricing.display_price.headline_price_components?object
objects[].pricing.original_price?object
objects[].pricing.original_price.total_price?string | null
objects[].pricing.original_price.price_breakdown?object
objects[].pricing.original_price.price_breakdown.tax?object
objects[].pricing.original_price.price_breakdown.tax.amount?string | null
objects[].pricing.original_price.price_breakdown.price?object
objects[].pricing.original_price.price_breakdown.price.amount?string | null
objects[].pricing.original_price.price_breakdown.shipping?object
objects[].pricing.original_price.price_breakdown.shipping.amount?string | null
objects[].pricing.original_price.price_breakdown.tax_type?string | null
objects[].pricing.original_price.price_breakdown.buyer_fee?object
objects[].pricing.original_price.price_breakdown.buyer_fee.amount?string | null
objects[].pricing.original_price.price_breakdown.shipping_id?string | null
objects[].pricing.original_price.price_breakdown.shipping_boundary?string | null
objects[].pricing.final_price_key?string | null
objects[].pricing.total_price_components?object
objects[].user_id?integer | null
objects[].brand_id?integer | null
objects[].location?string | null
objects[].pictures?object[]
objects[].pictures[].id?integer | null
objects[].pictures[].formats?object
objects[].pictures[].is_square?boolean | null
objects[].pictures[].original_width?integer | null
objects[].pictures[].original_height?integer | null
objects[].attributes?object
objects[].attributes.brand?string | null
objects[].attributes.group?string | null
objects[].attributes.colour?string[]
objects[].attributes.gender?string | null
objects[].attributes.is_kids?boolean | null
objects[].attributes.condition?string | null
objects[].attributes.product_type?string | null
objects[].attributes.additional_attributes?object
objects[].boosted_at?string | null
objects[].brand_name?string | null
objects[].created_at?string | null
objects[].is_boosted?boolean | null
objects[].like_count?integer | null
objects[].updated_at?string | null
objects[].description?string | null
objects[].variants_all?object[]
objects[].variants_all[].id?integer | null
objects[].variants_all[].name?string | null
objects[].variants_all[].status?string | null
objects[].variants_all[].variant?string | null
objects[].variants_all[].quantity?integer | null
objects[].active_status?string | null
objects[].category_name?string | null
objects[].variant_set_id?integer | null
objects[].listed_quantity?integer | null
objects[].shipping_method?object
objects[].shipping_method.payer?string | null
objects[].shipping_method.ship_from?integer | null
objects[].shipping_method.parcel_size?string | null
objects[].shipping_method.shipping_id?string | null
page_info?object
page_info.last?string | null
page_info.has_more?boolean, default: false

Fields 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.