# Rotten Tomatoes Search

Search public Rotten Tomatoes movies or TV by query through the same public search index the website uses. Each item carries the emsId, slug, mediaUrl, name, year, type, critic score, user score and full poster URL. Paging uses a real index page number. One credit per page with results.

- **Documentation:** [https://scrappa.co/docs/rottentomatoes-api/rottentomatoes_search](https://scrappa.co/docs/rottentomatoes-api/rottentomatoes_search)
- **API group:** Rotten Tomatoes API
- **Endpoint:** `GET https://scrappa.co/api/rottentomatoes/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 or tv. |
| `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)
