# Editorial Rottentomatoes — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for movies and TV shows, browse ratings and reviews from critics and audiences, and discover celebrity filmographies and entertainment news. Get detailed information about films, shows, and entertainment professionals all in one place.

**Category:** Entertainment | **Website:** [editorial.rottentomatoes.com/](https://editorial.rottentomatoes.com/) | **Docs:** [parse.bot/marketplace/a654383b-e36f-4522-ad53-fc0e5f36e944/editorial-rottentomatoes-com-api](https://parse.bot/marketplace/a654383b-e36f-4522-ad53-fc0e5f36e944/editorial-rottentomatoes-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Browse movies

Browse trending movies and TV shows from the Rotten Tomatoes homepage by category. Returns a single page of tile items with title, relative URL, poster image, and Tomatometer score percentage. No pagination; returns all items rendered on the browse page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Browse category |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/browse-movies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>"}'
```

### Get movie details

Retrieve comprehensive metadata for a movie by its URL slug. Returns structured JSON-LD data including title, cast, director, genre, content rating, aggregate Tomatometer rating, and the EMS ID needed for fetching critic reviews via get_reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_slug` | string | Yes | Movie slug from the Rotten Tomatoes URL path (e.g. 'dune_part_two', 'the_batman') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/get-movie-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"movie_slug":"<string>"}'
```

### Get news articles

Retrieve editorial news articles from the Rotten Tomatoes WordPress editorial site. Returns full post objects ordered by most recent, including title, excerpt, publication date, author info, and featured image URL. Supports page-based pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `per_page` | integer | No | Number of articles per page (max 100) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/get-news-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>"}'
```

### Get person details

Retrieve biographical details and filmography for an actor, director, or other film/TV personality by their URL slug. Returns JSON-LD Person metadata including name, birth date, birth place, description, and an itemListElement array containing their filmography with ratings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `person_slug` | string | Yes | Person slug from the Rotten Tomatoes celebrity URL path (e.g. 'timothee_chalamet', 'denis-villeneuve') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/get-person-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"person_slug":"<string>"}'
```

### Get reviews

Fetch paginated critic reviews for a movie or TV show by its EMS ID (obtained from get_movie_details or get_tv_show_details). Returns review text, critic info, sentiment, original score, and cursor-based pagination info. Tries both movie and TV review API endpoints internally.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Pagination cursor from previous response's pageInfo.endCursor |
| `ems_id` | string | Yes | EMS ID (UUID format) from get_movie_details or get_tv_show_details emsId field |
| `page_count` | integer | No | Number of reviews per page |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/get-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","ems_id":"<string>","page_count":"<integer>"}'
```

### Get tv show details

Retrieve comprehensive metadata for a TV show by its URL slug. Returns structured JSON-LD data including title, cast, seasons, genre, content rating, aggregate Tomatometer rating, and the EMS ID needed for fetching critic reviews via get_reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `show_slug` | string | Yes | TV show slug from the Rotten Tomatoes URL path (e.g. 'breaking_bad', 'the_last_of_us') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/get-tv-show-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"show_slug":"<string>"}'
```

### Search

Full-text search across movies, TV shows, and people on Rotten Tomatoes. Returns a single page of server-rendered results with title, URL, thumbnail, Tomatometer score (where available), and year. Results are not paginated; up to ~20 results returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/editorial-rottentomatoes/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.