# Editorial Rottentomatoes — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/browse_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/get_movie_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/get_news_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/get_person_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/get_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/get_tv_show_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-editorial-rottentomatoes-com-api-a654383b/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```