# Depop — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and discover products on Depop by searching inventory, viewing detailed product information, seller profiles, and reviews, while exploring trending items and the complete category structure. Filter listings by various criteria, access seller information including their likes and past sales, and find similar products to items you're interested in.

**Category:** Marketplaces | **Website:** [depop.com/](https://depop.com/) | **Docs:** [parse.bot/marketplace/77dae8bc-993b-4080-8b15-3992a050a0d5/depop-com-api](https://parse.bot/marketplace/77dae8bc-993b-4080-8b15-3992a050a0d5/depop-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_tree

Get the full category tree and size attribute groups. Returns the complete hierarchy of product categories (menswear, womenswear, kidswear, etc.) with subcategories, plus attribute groups with product types and their available attributes.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_category_tree \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_detail

Get full details of a single product listing by its slug. Returns extended product information including attributes, pricing breakdown, available sizes, seller reviews summary, and seller activity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug (e.g. 'seller-username-product-title-6ec4') or full product URL (e.g. 'https://www.depop.com/products/seller-username-product-title-6ec4/'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_seller_likes

Get items liked by a specific seller. Returns paginated results of products the seller has liked.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from previous response's last_offset_id field (base64-encoded). |
| `limit` | integer | No | Number of items to return per page. |
| `username` | string | Yes | Seller username on Depop. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_seller_likes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"<string>","limit":"<integer>","username":"<string>"}'
```

### get_seller_listings

Get active product listings for a specific seller. Returns paginated results with product summaries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from previous response's last_offset_id field. |
| `limit` | integer | No | Number of items to return per page. |
| `username` | string | Yes | Seller username on Depop. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_seller_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"<string>","limit":"<integer>","username":"<string>"}'
```

### get_seller_profile

Get public profile information for a seller by username. Returns profile details including name, bio, follower/following counts, review stats, and last seen timestamp.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Seller username on Depop. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_seller_reviews

Get reviews/feedback for a seller. Returns paginated review entries with ratings, text, product info, and reviewer details. Uses offset-based pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of reviews to return per page. |
| `offset` | integer | No | Pagination offset (0-based). Use next_offset from the response for the next page. |
| `username` | string | Yes | Seller username on Depop. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_seller_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","username":"<string>"}'
```

### get_similar_products

Get similar products for a given product ID. Returns up to 24 similar product listings based on the reference product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID (e.g. '677618705'). Can be obtained from search_products or get_seller_listings results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_similar_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_trending

Get trending/popular products from the Depop explore section. Returns paginated product listings without any search query filter, representing the current popular items on the platform.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from previous response's cursor field. |
| `limit` | integer | No | Number of items to return per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/get_trending \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"<string>","limit":"<integer>"}'
```

### search_products

Search for products on Depop with various filters. Returns paginated results with product summaries including pricing, images, sizes, and status. When max_results is provided, the scraper paginates internally (looping through cursor-based pages) and returns a single flat list of up to that many products; otherwise use the cursor from the response to paginate manually.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Brand ID or name to filter by. |
| `category` | string | No | Category slug (e.g. 'mens-accessories-belts'). Values from get_category_tree. |
| `colors` | string | No | Comma-separated color names to filter by. |
| `condition` | string | No | Condition ID to filter by. |
| `cursor` | string | No | Pagination cursor from previous response's cursor field. |
| `limit` | integer | No | Number of items to return per page (used as page size when max_results is set). |
| `max_results` | integer | No | When provided, paginates internally and returns a single flat list of up to this many products. All other filters still apply. Omitting returns a single page controlled by limit/cursor. |
| `on_sale` | boolean | No | If true, only return discounted items. |
| `price_max` | number | No | Maximum price in USD. |
| `price_min` | number | No | Minimum price in USD. |
| `query` | string | No | Search keyword. |
| `sizes` | string | No | Comma-separated size IDs to filter by. |
| `sort` | string | No | Sort order. Accepted values: relevance, priceAsc, priceDesc, newlyListed. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-depop-com-api-77dae8bc/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","category":"<string>","colors":"<string>","condition":"<string>","cursor":"<string>","limit":"<integer>","max_results":"<integer>","on_sale":"<boolean>","price_max":"<number>","price_min":"<number>","query":"<string>","sizes":"<string>","sort":"<string>"}'
```