# TrustedShops Category Shops

Browse shops within a TrustedShops category and market, then return paginated merchant profiles with TSIDs, names, ratings, review counts, certification state, categories, and profile URLs.

Use [TrustedShops Categories](/docs/trustedshops-api/trustedshops_categories) first to get valid category `urlPath` values for a market. Use [TrustedShops Shop Profile](/docs/trustedshops-api/trustedshops_shop) or [TrustedShops Reviews](/docs/trustedshops-api/trustedshops_reviews) when you want to enrich or monitor shops returned by this category browsing endpoint.

- **Documentation:** [https://scrappa.co/docs/trustedshops-api/trustedshops_category_shops](https://scrappa.co/docs/trustedshops-api/trustedshops_category_shops)
- **API group:** TrustedShops API
- **Endpoint:** `GET https://scrappa.co/api/trustedshops/category-shops`

## 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 |
| --- | --- | --- | --- |
| `category` | string | Yes | Category URL path (e.g. bekleidung). Use the Categories endpoint to get available values. |
| `page` | integer | No | Page number for pagination (0-500). Default: 0 |
| `market` | string | No | Market code filter (DEU, GBR, AUT, CHE, NLD, ESP, ITA, FRA, BEL, POL, PRT). Default: DEU |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/trustedshops/category-shops?category=bekleidung&page=0&market=DEU"
```

## Example response

```json
{
    "metaData": {
        "totalShopCount": 9678,
        "totalPageCount": 484
    },
    "shops": [],
    "categories": []
}
```

## Frequently asked questions

### What parameters does Category Shops need?

The endpoint requires a category `urlPath` value and optionally accepts `market` and `page` for country-specific pagination.

### How do I find valid TrustedShops category values?

Call the Categories endpoint for the target market first, then use one of the returned `urlPath` values as the `category` parameter.

### What should I do with shops returned by category browsing?

Use the returned TSIDs with Shop Profile for merchant metadata or Reviews for review-level records and rating analysis.

## Related endpoints

- [TrustedShops Categories](https://scrappa.co/docs/trustedshops-api/trustedshops_categories)
- [TrustedShops Markets](https://scrappa.co/docs/trustedshops-api/trustedshops_markets)
- [TrustedShops Shop Profile](https://scrappa.co/docs/trustedshops-api/trustedshops_shop)
- [TrustedShops Reviews](https://scrappa.co/docs/trustedshops-api/trustedshops_reviews)

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