# Metacritic Search

Search public Metacritic titles by query and type. The live-confirmed finder type id is sent upstream, so paging and the reported total cover only the requested movie, TV or game type. Each item carries the id, slug, name, year, type, critic score, image URL and genres. One credit per page with results. The user score is null in search by design and is available on the title route.

- **Documentation:** [https://scrappa.co/docs/metacritic-api/metacritic_search](https://scrappa.co/docs/metacritic-api/metacritic_search)
- **API group:** Metacritic API
- **Endpoint:** `GET https://scrappa.co/api/metacritic/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 text. |
| `type` | string | Yes | movie, tv or game. |
| `page` | integer | No | 1-based page. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | Bad query, type or page. Not charged. |
|  | Error | The upstream service is temporarily unavailable. Please retry shortly. |

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