# TrustedShops Markets

List every TrustedShops market supported by Scrappa and return the country names plus ISO alpha-3 market codes required by market-aware endpoints. This free metadata endpoint helps you choose valid country filters before running shop search, category discovery, or category browsing requests.

Use [TrustedShops Search](/docs/trustedshops-api/trustedshops_search) when you already know a shop or brand name. Use [TrustedShops Categories](/docs/trustedshops-api/trustedshops_categories) to fetch category URL paths for a market, then call [TrustedShops Category Shops](/docs/trustedshops-api/trustedshops_category_shops) to page through shops in that category.

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

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

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/trustedshops/markets"
```

## Example response

```json
{
    "success": true,
    "data": {
        "markets": [
            {
                "code": "DEU",
                "name": "Germany"
            },
            {
                "code": "GBR",
                "name": "United Kingdom"
            }
        ],
        "total_markets": 11
    },
    "message": "TrustedShops markets retrieved successfully"
}
```

## Frequently asked questions

### What are TrustedShops market codes?

TrustedShops market codes are ISO alpha-3 country codes such as `DEU`, `GBR`, `AUT`, and `FRA`. Scrappa uses them to scope TrustedShops search, category, and category shops requests to a supported country market.

### Does the Markets endpoint require an API key?

No. The Markets endpoint is a free metadata endpoint, so you can use it to validate supported country codes before sending authenticated shop search or category browsing requests.

### Which TrustedShops endpoint should I call after markets?

Use Search if you know a shop name or domain. Use Categories and then Category Shops if you want to browse merchants by category within a specific market.

## Related endpoints

- [TrustedShops Search](https://scrappa.co/docs/trustedshops-api/trustedshops_search)
- [TrustedShops Categories](https://scrappa.co/docs/trustedshops-api/trustedshops_categories)
- [TrustedShops Category Shops](https://scrappa.co/docs/trustedshops-api/trustedshops_category_shops)
- [TrustedShops Shop Profile](https://scrappa.co/docs/trustedshops-api/trustedshops_shop)

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