# Back Market Category API Documentation

<p><strong>Back Market Category API</strong> browses the first page of one category by its public slug and UUID from the site sitemap. Grade, brand and price filters are applied to the answer. Brand values are cleaned before matching. Only rows with a usable slug and UUID are returned. Every item carries numeric price and currency, condition grade, rating, review count, full-size image, a numeric product_id and a UUID listing_public_id for the detail route.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/backmarket-api/backmarket_category](https://scrappa.co/docs/backmarket-api/backmarket_category)
- **API group:** Back Market API
- **Endpoint:** `GET https://scrappa.co/api/backmarket/category`

## 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 |
| --- | --- | --- | --- |
| `slug` | string | Yes | Public category slug from the sitemap. |
| `uuid` | string | Yes | Public category UUID from the sitemap. |
| `grade` | string | No | Condition grade: Gut, Premium, Hervorragend or Sehr gut. |
| `brand` | string | No | Keep only this brand. |
| `price_min` | number | No | Minimum numeric price. |
| `price_max` | number | No | Maximum numeric price. |

## Example response

```json
{
    "data": {
        "slug": "smartphones",
        "products": [],
        "public_id": "6c290010-c0c2-47a4-b68a-ac2ec2b64dca",
        "pagination": {
            "page": 1,
            "count": 0,
            "total": null,
            "per_page": 31,
            "total_pages": null,
            "has_next_page": null
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "category"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Not billable. |
| 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)
