# Depop Similar Products API Documentation

<p><strong>Depop Similar Products API Documentation</strong> Get listings that Depop shows as similar to one listing. The rows use the same shape as the search endpoint. The data is public Depop data and the endpoint is read only. A failed request is never billed.</p>

- **Documentation:** [https://scrappa.co/docs/depop-api/depop_product_similar](https://scrappa.co/docs/depop-api/depop_product_similar)
- **API group:** Depop API
- **Endpoint:** `GET https://scrappa.co/api/depop/product/similar`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `product_id` | integer | Yes | Numeric listing id. |
| `country` | string | No | Depop market code, two letters, lowercase. List the codes with /api/depop/markets. Defaults to us. |
| `limit` | integer | No | Listings to return, 1 to 50. Defaults to 12. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": 959604592,
                "url": "https://www.depop.com/products/hoiezenrb-draper-james-blue-cropped-denim-6ebb/",
                "slug": "hoiezenrb-draper-james-blue-cropped-denim-6ebb",
                "brand": {
                    "id": 15257,
                    "name": "Draper James",
                    "slug": "draper-james"
                },
                "group": "coats-jackets",
                "gender": "female",
                "status": "STATUS_ONSALE",
                "is_sold": false,
                "seller_id": 390501153,
                "product_type": "jackets",
                "active_status": "active",
                "category_name": "Outerwear"
            },
            {
                "id": 960845412,
                "url": "https://www.depop.com/products/se5ondeditfw-shyanne-light-wash-cropped-denim-c34d/",
                "slug": "se5ondeditfw-shyanne-light-wash-cropped-denim-c34d",
                "brand": {
                    "id": 14806,
                    "name": "Shyanne",
                    "slug": "shyanne"
                },
                "group": "coats-jackets",
                "gender": "female",
                "status": "STATUS_ONSALE",
                "is_sold": false,
                "seller_id": 222287722,
                "product_type": "jackets",
                "active_status": "active",
                "category_name": "Outerwear"
            }
        ],
        "pagination": {
            "has_more": false
        },
        "product_id": 960845412
    },
    "meta": {
        "billable": true,
        "endpoint_family": "product_similar"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Depop is not called and the request is not billable. |
| 404 | Resource Not Found | Depop does not know this id or slug. This response is not billable. |
| 503 | Upstream Unavailable | Depop did not answer after several tries. Retry later. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)