# Depop Categories API Documentation

<p><strong>Depop Categories API Documentation</strong> Get the category data you need to build valid filters. The filters view lists departments with their groups and product types. The groups view adds attributes and measurements per product type with names in several languages. The size_mapping view maps each category to its size sets. The data changes slowly and is cached for hours. 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_categories](https://scrappa.co/docs/depop-api/depop_categories)
- **API group:** Depop API
- **Endpoint:** `GET https://scrappa.co/api/depop/categories`

## 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 |
| --- | --- | --- | --- |
| `view` | string | No | filters (default), groups or size_mapping. |

## Example response

```json
{
    "data": {
        "data": {
            "groups": {
                "tops": [
                    {
                        "id": "tshirts",
                        "name": "T-shirts",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "jerseys",
                        "name": "Jerseys",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "suits": [
                    {
                        "id": "suits",
                        "name": "Suits",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "tailored-jackets",
                        "name": "Tailored jackets",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "bottoms": [
                    {
                        "id": "jeans",
                        "name": "Jeans",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "joggers-tracksuits",
                        "name": "Sweatpants",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "dresses": [
                    {
                        "id": "casual-dresses",
                        "name": "Casual dresses",
                        "department": [
                            "womenswear",
                            "kidswear"
                        ]
                    },
                    {
                        "id": "formal-dresses",
                        "name": "Formal dresses",
                        "department": [
                            "womenswear",
                            "kidswear"
                        ]
                    }
                ],
                "footwear": [
                    {
                        "id": "trainers",
                        "name": "Sneakers",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "slides",
                        "name": "Slides",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "nightwear": [
                    {
                        "id": "pajamas",
                        "name": "Pajamas",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "robes",
                        "name": "Robes",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "underwear": [
                    {
                        "id": "bandeaus",
                        "name": "Bandeaus",
                        "department": [
                            "womenswear"
                        ]
                    },
                    {
                        "id": "bras",
                        "name": "Bras",
                        "department": [
                            "womenswear"
                        ]
                    }
                ],
                "accessories": [
                    {
                        "id": "bag",
                        "name": "Bags",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "belt",
                        "name": "Belts",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "fancy-dress": [
                    {
                        "id": "fancy-dress",
                        "name": "Costume",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "coats-jackets": [
                    {
                        "id": "coats",
                        "name": "Coats",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "jackets",
                        "name": "Jackets",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ],
                "swim-beach-wear": [
                    {
                        "id": "bikinis-and-tankini-sets",
                        "name": "Bikini and tankini sets",
                        "department": [
                            "womenswear",
                            "kidswear"
                        ]
                    },
                    {
                        "id": "bikini-and-tankini-tops",
                        "name": "Bikini and tankini tops",
                        "department": [
                            "womenswear"
                        ]
                    }
                ],
                "jumpsuit-and-playsuit": [
                    {
                        "id": "jumpsuit",
                        "name": "Jumpsuits",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    },
                    {
                        "id": "playsuit-romper",
                        "name": "Rompers",
                        "department": [
                            "menswear",
                            "womenswear"
                        ]
                    }
                ]
            },
            "departments": [
                {
                    "id": "menswear",
                    "name": "Men",
                    "children": [
                        {
                            "id": "tops",
                            "name": "Tops"
                        },
                        {
                            "id": "bottoms",
                            "name": "Bottoms"
                        }
                    ]
                },
                {
                    "id": "womenswear",
                    "name": "Women",
                    "children": [
                        {
                            "id": "tops",
                            "name": "Tops"
                        },
                        {
                            "id": "bottoms",
                            "name": "Bottoms"
                        }
                    ]
                }
            ]
        },
        "view": "filters"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "categories"
    },
    "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. |
| 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)