# Depop Search Facets API Documentation

<p><strong>Depop Search Facets API Documentation</strong> Get the live counts behind a search: total hits and the number of listings per department, group, product type, brand, colour, condition and size. Use it to build filter menus without a second search. The answer is cached for a few minutes. 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_facets](https://scrappa.co/docs/depop-api/depop_facets)
- **API group:** Depop API
- **Endpoint:** `GET https://scrappa.co/api/depop/facets`

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search keywords, for example jacket. |
| `country` | string | No | Depop market code, two letters, lowercase. List the codes with /api/depop/markets. Defaults to us. |

## Example response

```json
{
    "data": {
        "query": "jacket",
        "sizes": {
            "2.3": 1,
            "2.5": 1,
            "2.6": 1,
            "2.7": 1,
            "2.8": 4,
            "2.9": 2,
            "4.2": 200,
            "2.10": 14,
            "2.11": 9,
            "2.12": 7,
            "2.13": 7,
            "4.14": 367
        },
        "total": 700000,
        "brands": {
            "2": {
                "count": 67
            },
            "3": {
                "count": 54
            },
            "4": {
                "count": 110
            },
            "9": {
                "count": 1259
            },
            "10": {
                "count": 167
            },
            "13": {
                "count": 777
            },
            "14": {
                "count": 98
            },
            "17": {
                "count": 161
            },
            "22": {
                "count": 95
            },
            "23": {
                "count": 1907
            },
            "25": {
                "count": 77
            },
            "26": {
                "count": 191
            }
        },
        "colours": {
            "blue": {
                "count": 135256
            },
            "gold": {
                "count": 5642
            },
            "grey": {
                "count": 92084
            },
            "pink": {
                "count": 38473
            },
            "brown": {
                "count": 62818
            },
            "green": {
                "count": 54649
            },
            "khaki": {
                "count": 21328
            },
            "orange": {
                "count": 14361
            },
            "purple": {
                "count": 21370
            },
            "silver": {
                "count": 5183
            },
            "yellow": {
                "count": 11204
            },
            "burgundy": {
                "count": 14092
            }
        },
        "country": "us",
        "conditions": {
            "brand_new": {
                "count": 90873
            },
            "used_fair": {
                "count": 18817
            },
            "used_good": {
                "count": 160316
            },
            "used_like_new": {
                "count": 109757
            },
            "used_excellent": {
                "count": 315519
            }
        },
        "departments": {
            "kidswear": {
                "count": 25744,
                "groups": [],
                "product_types": []
            },
            "menswear": {
                "count": 223980,
                "groups": {
                    "art": {
                        "count": 1
                    },
                    "bottoms": {
                        "count": 3566
                    },
                    "footwear": {
                        "count": 103
                    },
                    "nightwear": {
                        "count": 35
                    },
                    "underwear": {
                        "count": 19
                    },
                    "accessories": {
                        "count": 1344
                    },
                    "fancy-dress": {
                        "count": 83
                    },
                    "coats-jackets": {
                        "count": 162311
                    },
                    "swim-beach-wear": {
                        "count": 84
                    },
                    "books-and-magazine": {
                        "count": 23
                    },
                    "jumpsuit-and-playsuit": {
                        "count": 453
                    },
                    "sports-equipment-accesories": {
                        "count": 4
                    }
                },
                "product_types": {
                    "belt": {
                        "count": 14
                    },
                    "shorts": {
                        "count": 409
                    },
                    "slides": {
                        "count": 1
                    },
                    "jumpers": {
                        "count": 3458
                    },
                    "tshirts": {
                        "count": 4801
                    },
                    "bodysuits": {
                        "count": 15
                    },
                    "boat-shoes": {
                        "count": 1
                    },
                    "fancy-dress": {
                        "count": 83
                    },
                    "other-footwear": {
                        "count": 5
                    },
                    "other-underwear": {
                        "count": 5
                    },
                    "other-swim-beach-wear": {
                        "count": 63
                    },
                    "bikini-and-tankini-tops": {
                        "count": 1
                    }
                }
            },
            "womenswear": {
                "count": 421670,
                "groups": {
                    "tops": {
                        "count": 56639
                    },
                    "suits": {
                        "count": 15425
                    },
                    "bottoms": {
                        "count": 5614
                    },
                    "dresses": {
                        "count": 6387
                    },
                    "footwear": {
                        "count": 207
                    },
                    "nightwear": {
                        "count": 425
                    },
                    "underwear": {
                        "count": 122
                    },
                    "accessories": {
                        "count": 4615
                    },
                    "fancy-dress": {
                        "count": 232
                    },
                    "coats-jackets": {
                        "count": 329267
                    },
                    "swim-beach-wear": {
                        "count": 269
                    },
                    "jumpsuit-and-playsuit": {
                        "count": 1345
                    }
                },
                "product_types": {
                    "belt": {
                        "count": 54
                    },
                    "robes": {
                        "count": 192
                    },
                    "courts": {
                        "count": 10
                    },
                    "shorts": {
                        "count": 416
                    },
                    "fancy-dress": {
                        "count": 232
                    },
                    "prom-dresses": {
                        "count": 8
                    },
                    "work-dresses": {
                        "count": 42
                    },
                    "other-footwear": {
                        "count": 12
                    },
                    "other-underwear": {
                        "count": 16
                    },
                    "wedding-dresses": {
                        "count": 36
                    },
                    "other-swim-beach-wear": {
                        "count": 87
                    },
                    "bikini-and-tankini-tops": {
                        "count": 10
                    }
                }
            },
            "everything_else": {
                "count": 14350,
                "groups": {
                    "art": {
                        "count": 3555
                    },
                    "film": {
                        "count": 73
                    },
                    "home": {
                        "count": 1317
                    },
                    "toys": {
                        "count": 2703
                    },
                    "music": {
                        "count": 1278
                    },
                    "beauty": {
                        "count": 24
                    },
                    "umbrella": {
                        "count": 14
                    },
                    "face-masks": {
                        "count": 29
                    },
                    "party-supplies": {
                        "count": 54
                    },
                    "tech-accessories": {
                        "count": 19
                    },
                    "books-and-magazine": {
                        "count": 4660
                    },
                    "sports-equipment-accesories": {
                        "count": 624
                    }
                },
                "product_types": {
                    "makeup": {
                        "count": 2
                    },
                    "dinnerware": {
                        "count": 61
                    },
                    "face-masks": {
                        "count": 29
                    },
                    "collectibles": {
                        "count": 2926
                    },
                    "water-sports": {
                        "count": 134
                    },
                    "bath-and-body": {
                        "count": 3
                    },
                    "trading-cards": {
                        "count": 312
                    },
                    "winter-sports": {
                        "count": 108
                    },
                    "home-appliances": {
                        "count": 1
                    },
                    "stuffed-animals": {
                        "count": 643
                    },
                    "cameras-and-accessories": {
                        "count": 73
                    },
                    "drawing-and-illustrations": {
                        "count": 19
                    }
                }
            }
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "facets"
    },
    "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)