Depop API endpoint
Returns items similar to a given Depop listing, via Depop's dedicated similar-items API -- richer and paginated (up to 150 per page) compared to the small, non-paginated "similar items" carousel already included in item detail. Public data sourced from Depop's own similar-items API.
/depop/item/{slug}/similarPath parameters:
slug (required) — the Depop item URL slug (e.g.
ag_boutique-vintage-mid-rise-bootcut-levi-2476), as returned by a search
result's id field.Query parameters:
limit (optional) — max results per page, 1-150. Defaults to 24
when omitted.after (optional) — an opaque pagination cursor from a previous
response's next_cursor field. Omit for the first page.Notable response behavior:
503 means both paths were blocked. Retry later./depop/search's listing summaries
(title, price, brand, condition, like count, photos, sizes).slug to the source item requires an internal item-page fetch
before the similar-items lookup — allow for slightly higher latency than
/depop/search.has_more and next_cursor reflect Depop's own pagination state — when
has_more is true, pass next_cursor as the following request's
after value to fetch the next page.404.slug or a limit over 150 returns 400 before any
upstream request is made.| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| id | 24 | |
| url | 24 | depop.com |
| title | 24 | “NIKE ACG SMITH SUMMIT UV JACKET THUNDER BLUE MEN’S XL” and 23 other values |
| description | 24 | median 174 characters |
| brand_name | 24 | Nike ACG (15), Nike (8), NOCTA (1) |
| condition | 24 | used_good (9), brand_new (8), used_excellent (5) and 2 more |
| colours | 22 | median 2 entries |
| price_cents | 24 | 2,499 to 10,000, median 7,500 |
| currency | 24 | USD in all 24 |
| shipping_cents | 24 | 199 to 800, median 399 |
| thumbnail_url | 24 | media-photos.depop.com |
| photos | 24 | median 6 entries |
| sizes | 24 | median 1 entry |
| location | 24 | “Manor, United States” and 20 other values |
| like_count | 23 | 1 to 65, median 11 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | Depop item URL slug, e.g. from a search result's id field | ag_boutique-vintage-mid-rise-bootcut-levi-2476 | |
| limit | integer | No | Max results per page, 1-150 | 24 | |
| after | string | No | Opaque pagination cursor from a previous response's next_cursor field. Omit for the first page. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/depop/item/ag_boutique-vintage-mid-rise-bootcut-levi-2476/similar?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"items": [
{
"id": "rayofsuashineva-artsy-chic-boho-luxe-eclectic-d9c0",
"url": "https://www.depop.com/products/rayofsuashineva-artsy-chic-boho-luxe-eclectic-d9c0/",
"title": "Artsy chic",
"description": "Artsy chic\n\nBoho luxe\n\nMichael Simon jacket, multicolor plaid jacket",
"brand_name": "Other",
"condition": "used_excellent",
"colours": [
"multi"
],
"price_cents": 2500,
"currency": "USD",
"shipping_cents": 199,
"thumbnail_url": "https://media-photos.depop.com/b1/264682642/4443656880_c7418b1968634a5a8a7e98ba0a863801/P0.jpg",
"sizes": [
"M"
],
"location": "Durham, United States",
"like_count": 0
}
],
"has_more": true,
"next_cursor": "NQ"
}
}Request schema
No body schema
Response schema
#/definitions/depop.similarItemsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | depop.SimilarItemsResponse | No | ||||
| data.has_more | boolean | No | HasMore indicates additional results exist beyond this page. When true, NextCursor can be passed as the next request's After field. | |||
| data.items | array | No | ItemSummary record, 15 fields: brand_name, colours, condition, currency, description, id, like_count, location, photos, price_cents, shipping_cents, sizes and 3 more. Described under Depop item API. | |||
| data.next_cursor | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/depop/item/ag_boutique-vintage-mid-rise-bootcut-levi-2476/similar?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"