# Back Market Facets API Documentation

<p><strong>Back Market Facets API</strong> returns the public search facets, price buckets and clean sort options that the site ships to every anonymous visitor. It also names the public id source so a slug and UUID can be fed into the category route. The answer is cached for 24 hours.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/backmarket-api/backmarket_facets](https://scrappa.co/docs/backmarket-api/backmarket_facets)
- **API group:** Back Market API
- **Endpoint:** `GET https://scrappa.co/api/backmarket/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.

## Example response

```json
{
    "data": {
        "cache": "miss",
        "facets": [
            {
                "name": "brand",
                "type": "checkbox",
                "title": "Marke"
            }
        ],
        "id_source": "https://www.backmarket.de/sitemap_landings.xml",
        "grade_enum": [
            "Gut",
            "Premium",
            "Hervorragend",
            "Sehr gut"
        ],
        "sort_options": [
            {
                "key": "product_filter_sort_best_sales",
                "label": "Bestseller"
            }
        ],
        "price_buckets": []
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "facets"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Upstream Unavailable | The upstream blocked the request. Not billable and retryable. |

## 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)
