# Epic Games Store Search API Documentation

Search public Epic Games Store data by keyword. Returns offers with numeric prices, release date, developer, publisher, images and honest paging. Regions US, DE and GB are supported. A valid empty result is billable.

- **Documentation:** [https://scrappa.co/docs/epic-games-api/epic_games_search](https://scrappa.co/docs/epic-games-api/epic_games_search)
- **API group:** Epic Games Store API
- **Endpoint:** `GET https://scrappa.co/api/epic-games/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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search keyword. Example: witcher. |
| `region` | string | No | US, DE or GB. Defaults to US. |
| `sort` | string | No | relevance, release_date, price_asc, price_desc or title. |
| `page` | integer | No | Page number, 1 to 100. Defaults to 1. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/epic-games/search?query=witcher&region=US&sort=relevance&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "items": [],
        "page": 1,
        "count": 0,
        "total": 0,
        "query": "witcher",
        "region": "US",
        "sort": "relevance"
    },
    "meta": {
        "endpoint_family": "epic_search",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. Non-billable. |
| 503 | Upstream Unavailable | The source could not be reached or changed shape. Retryable and never billed. |

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