DEdepop
Products - By Product ID

Get product details by product ID

This endpoint allows you to get the details of a product by its internal product ID. Required OAuth Scopes: - products_read - Required to access product information - offers_read - Optional. Required to include offer pricing information (auto_send_offer_price, auto_negotiate_offer_price) in the response. If this scope is not provided, these fields will be omitted from the response.

get/api/v1/products/by-product-id/{productId}/

Request

Path parameters

productIdinteger required

The internal product ID of the product.

Response

A single product

skustring nullable

SKU of the product. This field is optional and will be null if no SKU was assigned to the product.

product_idnumber required

The id of the product.

slugstring required

The URL-friendly slug of the product. Can be used to construct the product URL as https://www.depop.com/products/{slug}/.

status'STATUS_ONSALE' | 'STATUS_PURCHASED' | 'STATUS_MARKED_AS_SOLD' | 'STATUS_DELETED' | 'STATUS_DELETED_ONSALE' | 'STATUS_DELETED_PURCHASED' | 'STATUS_DELETED_MARKED_AS_SOLD' | 'STATUS_PRODUCT_BANNED_ONSALE' | 'STATUS_USER_BANNED_ONSALE' | 'STATUS_PRODUCT_BANNED_PURCHASED' | 'STATUS_USER_BANNED_PURCHASED' required

The status of the product.

descriptionstring required

A good description should contain key attribute information (brand, category, color, size, age etc), clarifying information about flaws, condition, fit, size and measurements. Commonly they end with hash tags (for example, #summer). Constraints:

  • Limited to 1000 characters
  • Email addresses are not allowed
  • Can only have up to 5 hashtags (for example, #summer).
price_currencystring required

The currency code of the item's price.

price_amountstring required

The price of the item. Must be at least $1.00 or £1.00. Up to 2 decimal places.

current_pricestring

The current effective price of the item, reflecting any active discount. Equal to price_amount when no discount is applied.

discount_pricestring

The discounted price of the item. Only present when the seller has an active discount on the product.

auto_send_offer_pricestring

The price to automatically send to buyers who liked or have bagged the product. There's a fixed 1h delay before an offer is sent. If not set, the product will not automatically send offers. Must be less at least 5% off the price_amount. Up to 2 decimal places. Note: Requires offers_read OAuth scope to include this field in the response. If scope is not provided, this field will be omitted.

auto_negotiate_offer_pricestring

The price to automatically respond with when a buyer sends an offer in this product:

  • If the buyer offer is higher or equal to this value, then the offer will be automatically accepted.
  • If the buyer offer is lower than this value, then the offer will be automatically countered with this price.

If the buyer counters again, the same value will be used to counter the buyer's offer. If not set, the offers will not be automatically responded to. Must be less at least 5% off the price_amount. Up to 2 decimal places. Note: Requires offers_read OAuth scope to include this field in the response. If scope is not provided, this field will be omitted.

international_shipping_coststring

The cost of shipping the product internationally. Only set this if the product can be shipped internationally. Same currency as price_currency.

national_shipping_coststring

The cost of shipping the product nationally. Same currency as price_currency. If set to 0, the product has free shipping for buyers. Important: Either national_shipping_cost OR depop_shipping must be provided. If using Depop managed shipping, use depop_shipping instead and omit this field.

quantitynumber required

The quantity of the product available for sale. Must be at least 1.

departmentstring required

Top level category of the product. Currently we support: womenswear, menswear, kidswear and everything-else. These rarely change. For an up to date list, please make use of our taxonomy endpoint. Currently, in https://api.depop.com/api/v3/attributes/ under the key department.

product_typestring required

The more specific category of the product. Note that there's an intermediate level between department and product type called "group". We don't need to receive this when an item is being listed but it's used in the apps/website to organize the product types. For example, in "menswear >> swim-beach-wear >> swimsuit-one-piece", we only need to know the department "menswear" and the product type "swimsuit-one-piece". For an up to date list, please make use of our taxonomy endpoint. Currently, in https://api.depop.com/api/v3/attributes/ under the key group.

size_set_idnumber

The size set ID for the given Department and Product Type.

size_idnumber

The size ID for a given size Set ID.

condition'brand_new' | 'used_like_new' | 'used_excellent' | 'used_good' | 'used_fair'
colourstring[] required
stylestring[] required
agestring[] required
sourcestring[] required
brandstring required

The brand name of the product. For example, "Nike".

attributesobject required

Additional attributes of the product. For an up to date list, please make use of our attributes endpoint.

is_boostedboolean required

Whether the product is currently boosted.

created_atstring date-time required

The date and time when the product was created.

updated_atstring date-time required

The date and time when the product was last updated.

Example response

{
  "sku": "ABC-12345-S-BL",
  "product_id": 123456789,
  "slug": "vintage-nike-t-shirt-123456789",
  "status": "STATUS_ONSALE",
  "address": {
    "country_code": "GB",
    "state": "Greater London"
  },
  "description": "Women's Burgundy and Purple Vest\nMauve and white striped tank top  Small mark at the bottom of the hem \n#stripes #summer",
  "price_currency": "GBP",
  "price_amount": "50.99",
  "current_price": "45.99",
  "discount_price": "45.99",
  "auto_send_offer_price": "45.00",
  "auto_negotiate_offer_price": "45.00",
  "international_shipping_cost": "5.0",
  "national_shipping_cost": "2.0",
  "depop_shipping": {
    "address_id": 123456,
    "shipping_provider_id": "USPS",
    "parcel_size_id": "SMALL",
    "payer": "buyer"
  },
  "quantity": 1,
  "pictures": [
    {
      "url": "https://images.example.com/products/vintage-nike-tshirt-front.jpg",
      "height": 1280,
      "width": 1280
    },
    {
      "url": "https://images.example.com/products/vintage-nike-tshirt-back.jpg",
      "height": 1280,
      "width": 1280
    },
    {
      "url": "https://images.example.com/products/vintage-nike-tshirt-detail.jpg",
      "height": 1280,
      "width": 1280
    }
  ],
  "department": "womenswear",
  "product_type": "tshirts",
  "size_set_id": 2,
  "size_id": 10,
  "condition": "brand_new",
  "colour": [
    "black",
    "white"
  ],
  "style": [
    "streetwear",
    "goth"
  ],
  "age": [
    "90s"
  ],
  "source": [
    "vintage"
  ],
  "brand": "Nike",
  "attributes": {
    "sleeve-length": [
      "short"
    ],
    "occasion": [
      "wedding"
    ]
  },
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-01T00:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.