# Depop Shop Aggregates API Documentation

<p><strong>Depop Shop Aggregates API Documentation</strong> Get how many items a seller has in each category, brand, colour, condition and size, plus the total. 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_shop_aggregates](https://scrappa.co/docs/depop-api/depop_shop_aggregates)
- **API group:** Depop API
- **Endpoint:** `GET https://scrappa.co/api/depop/shop/aggregates`

## 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 |
| --- | --- | --- | --- |
| `seller_id` | integer | Yes | Numeric seller id. Get it from product.seller.id or from /api/depop/users/search. |

## Example response

```json
{
    "data": {
        "sizes": {
            "22.3": 1,
            "22.7": 1,
            "22.8": 2,
            "4.15": 4,
            "4.16": 18,
            "4.17": 13,
            "4.18": 2,
            "4.32": 1,
            "22.16": 1,
            "22.17": 1,
            "22.27": 3,
            "22.28": 6
        },
        "total": 160,
        "brands": {
            "9": {
                "count": 1
            },
            "32": {
                "count": 1
            },
            "55": {
                "count": 1
            },
            "98": {
                "count": 1
            },
            "147": {
                "count": 3
            },
            "158": {
                "count": 2
            },
            "189": {
                "count": 1
            },
            "195": {
                "count": 1
            },
            "212": {
                "count": 3
            },
            "222": {
                "count": 1
            },
            "277": {
                "count": 1
            },
            "282": {
                "count": 1
            }
        },
        "colours": {
            "red": {
                "count": 16
            },
            "tan": {
                "count": 12
            },
            "blue": {
                "count": 31
            },
            "gold": {
                "count": 4
            },
            "grey": {
                "count": 7
            },
            "pink": {
                "count": 20
            },
            "brown": {
                "count": 14
            },
            "green": {
                "count": 9
            },
            "orange": {
                "count": 6
            },
            "purple": {
                "count": 3
            },
            "silver": {
                "count": 17
            },
            "yellow": {
                "count": 6
            }
        },
        "seller_id": 222287722,
        "categories": {
            "kidswear": {
                "count": 0,
                "variants": {
                    "male": {
                        "count": 0,
                        "variants": []
                    },
                    "female": {
                        "count": 0,
                        "variants": []
                    },
                    "unisex": {
                        "count": 0,
                        "variants": []
                    }
                }
            },
            "menswear": {
                "count": 2,
                "variants": {
                    "tops": {
                        "count": 1
                    },
                    "gilets": {
                        "count": 1
                    },
                    "blouses": {
                        "count": 1
                    },
                    "coats-jackets": {
                        "count": 1
                    }
                }
            },
            "womenswear": {
                "count": 158,
                "variants": {
                    "belt": {
                        "count": 1
                    },
                    "tops": {
                        "count": 38
                    },
                    "shorts": {
                        "count": 6
                    },
                    "bottoms": {
                        "count": 20
                    },
                    "dresses": {
                        "count": 45
                    },
                    "footwear": {
                        "count": 9
                    },
                    "nightwear": {
                        "count": 2
                    },
                    "accessories": {
                        "count": 23
                    },
                    "scarf-wraps": {
                        "count": 2
                    },
                    "coats-jackets": {
                        "count": 4
                    },
                    "swim-beach-wear": {
                        "count": 2
                    },
                    "jumpsuit-and-playsuit": {
                        "count": 1
                    }
                }
            },
            "everything-else": {
                "count": 0,
                "variants": []
            }
        },
        "conditions": {
            "brand_new": {
                "count": 9
            },
            "used_fair": {
                "count": 2
            },
            "used_good": {
                "count": 24
            },
            "used_like_new": {
                "count": 7
            },
            "used_excellent": {
                "count": 118
            }
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "shop_aggregates"
    },
    "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)