# TrustedShops Search

Search TrustedShops shop profiles by brand name, domain, or merchant keyword and return matching European e-commerce shops as structured JSON. Each result can include the shop name, TSID, TrustedShops profile URL, rating summary, review count, category assignments, certification state, and market-specific metadata.

Use this endpoint when you need to resolve a human search term into TrustedShops identifiers before calling [TrustedShops Shop Profile](/docs/trustedshops-api/trustedshops_shop) or [TrustedShops Reviews](/docs/trustedshops-api/trustedshops_reviews). Pair search with [TrustedShops Markets](/docs/trustedshops-api/trustedshops_markets) to choose the right country code and [TrustedShops Categories](/docs/trustedshops-api/trustedshops_categories) when building category-level shop discovery workflows.

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

## 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 |
| --- | --- | --- | --- |
| `q` | string | Yes | Shop search query |
| `page` | integer | No | Page number for pagination (0-100) |
| `market` | string | No | Market code filter (DEU, GBR, AUT, CHE, NLD, ESP, ITA, FRA, BEL, POL, PRT) |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "metaData": {
        "totalShopCount": 4227,
        "totalPageCount": 212
    },
    "shops": [],
    "categories": []
}
```

## Frequently asked questions

### What does the TrustedShops Search API return?

The search endpoint returns matching shop profiles with fields such as shop name, TSID, profile URL, average rating, review count, certification state, categories, and market-specific profile metadata when TrustedShops exposes it.

### How do I get a TSID for another TrustedShops endpoint?

Start with TrustedShops Search using a shop name, brand, or domain. Use the `tsID` value from a matching result when calling the Shop Profile or Reviews endpoint.

### Can I restrict TrustedShops search to one country?

Yes. Pass the `market` parameter with a supported ISO alpha-3 code such as `DEU`, `GBR`, or `FRA`. Use the Markets endpoint to list every supported code.

## Related endpoints

- [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)
- [TrustedShops Categories](https://scrappa.co/docs/trustedshops-api/trustedshops_categories)

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