GET/rottentomatoes/browse/filtersapiKey2 credits/request
Returns every filter and accepted value exposed by the selected live Rotten Tomatoes browse page. Call this before building filtered movie or TV browse requests; values differ by list and update with the site's menus.
Optional: list (4 allowed values: movies_in_theaters, movies_at_home, movies_coming_soon, tv_series_browse).
Sampled 14 Oct 2026: 6 items. Filled in every item: key, label, values. In the sample: label: “Sort” and 5 other values; values: median 7 entries.
Open in Playground
GET/rottentomatoes/browse/moviesapiKey2 credits/request
Returns movie rows from Rotten Tomatoes' browse listing. Use `/rottentomatoes/browse/filters` to discover current values for each list. Filters accept comma-separated values; pagination uses the opaque `after` cursor from the previous response.
Optional: list (3 allowed values: movies_in_theaters, movies_at_home, movies_coming_soon), sort (8 allowed values: popular, newest, top_box_office, a_z, critic_highest, critic_lowest, audience_highest, audience_lowest), genres (38 allowed values: action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, lgbtq, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western), ratings (7 allowed values: g, pg, pg_13, r, nc_17, nr, ur), audience (3 allowed values: verified_hot, upright, spilled), critics (3 allowed values: certified_fresh, fresh, rotten), affiliates (13 allowed values: theaters, fandango, apple-tv-plus, netflix, prime-video, disney-plus, max, peacock, hulu, paramount-plus, amc-plus, acorn-tv, apple-tv), after, limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: position, media_type, title, path, url, image_url, date_created. Not in every item: tomatometer_score (8). In the sample: date_created: Opened Oct 09, 2026 (6), Opens Oct 16, 2026 (3), Re-releasing Oct 14, 2026 (1); position: 1 to 10, median 5; title: “Other Mommy” and 9 other values; url: rottentomatoes.com; path: “/m/other_mommy” and 9 other values; image_url: resizing.flixster.com; tomatometer_score: 16 to 100, median 55.
Open in Playground
GET/rottentomatoes/browse/tvapiKey2 credits/request
Returns TV series rows from Rotten Tomatoes' browse listing. Use `/rottentomatoes/browse/filters?list=tv_series_browse` to discover current filters; pagination uses the opaque `after` cursor from the previous response.
Optional: list (tv_series_browse), sort (7 allowed values: popular, newest, a_z, critic_highest, critic_lowest, audience_highest, audience_lowest), genres (38 allowed values: action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, lgbtq, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western), ratings (6 allowed values: tvy, tvy7, tvg, tvpg, tv14, tvma), audience (2 allowed values: upright, spilled), critics (2 allowed values: fresh, rotten), affiliates (13 allowed values: theaters, fandango, apple-tv-plus, netflix, prime-video, disney-plus, max, peacock, hulu, paramount-plus, amc-plus, acorn-tv, apple-tv), after, limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: position, media_type, title, path, url, image_url, tomatometer_score. Not in every item: date_created (9). In the sample: position: 1 to 10, median 5; title: “Carrie” and 9 other values; url: rottentomatoes.com; path: “/tv/carrie” and 9 other values; image_url: resizing.flixster.com; date_created: “Latest Episode: Oct 07” and 5 other values; tomatometer_score: 41 to 100, median 87.
Open in Playground
GET/rottentomatoes/critic/publicationsapiKey3 credits/request
Returns the publications one Rotten Tomatoes critic writes for: publication name, editorial site URL, logo image, encrypted and numeric publication ids, and the top-publication and Tomatometer-approved flags. The list is read directly from Rotten Tomatoes' feed (normally a second or two), with a slower browser fallback when the feed cannot be read. Only the first page is served today; `data.page_info.end_cursor` reports that more exist. An unknown critic path returns 404. Pass exactly one of `path` or `url`.
Optional: path, url.
Open in Playground
GET/rottentomatoes/critics/authorsapiKey2 credits/request
Returns current or inactive critics from Rotten Tomatoes' public author directory. Browse one letter or search by name; use `next_cursor` as `after` or `previous_cursor` as `before`, as indicated by the corresponding page flag. The letter values come from the live directory controls.
Optional: letter (27 allowed values: #, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z), search, inactive, after, before, limit.
Sampled 14 Oct 2026: 40 items. Filled in every item: name, path. Not in every item: publication_label (19), publications (19), badges (21). In the sample: publications: median 1 entry; badges: median 1 entry.
Open in Playground
GET/rottentomatoes/editorial/contentapiKey2 credits/request
Lists paginated editorial records from the selected public content type. The pages collection lists public editorial section and campaign indexes. Use the editorial types endpoint to discover accepted type values.
Required: type (11 allowed values: article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, pages). Optional: query, page, limit, taxonomy (10 allowed values: categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors), term_ids, operator (2 allowed values: AND, OR), include_children.
Sampled 14 Oct 2026: 2 items. Filled in every item: id, type, title, url, published_at, modified_at, author_id. In the sample: published_at: 2015-10-28 to 2016-04-19; type: “page”; url: editorial.rottentomatoes.com; title: median 9 characters; modified_at: 2026-01-23 to 2026-01-26.
Open in Playground
GET/rottentomatoes/editorial/detailapiKey2 credits/request
Returns the public body, paragraphs, headings, links, images, and video embeds from an Editorial article, gallery, guide, on-the-go article, or preview. Discover paths from editorial content collections. The response body_html preserves public Gutenberg/ranked-list markup.
Required: path.
Sampled 14 Oct 2026: 478 items. Filled in every item: text, url. In the sample: url: rottentomatoes.com and 2 other hosts; text: median 13 characters.
Open in Playground
GET/rottentomatoes/editorial/searchapiKey2 credits/request
Searches public Rotten Tomatoes editorial content, including articles and guides. Results include content subtype plus total-page metadata.
Required: query. Optional: page, limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, title, url, type, subtype. In the sample: subtype: guide (6), article (4); url: editorial.rottentomatoes.com; title: median 34 characters.
Open in Playground
GET/rottentomatoes/editorial/sectionapiKey2 credits/request
Returns the rendered article cards for a discovered editorial page, RT hub, or hub subpage. Discover paths through editorial content types `pages`, `rt-hub`, and `hub-subpage`. Static pages use `articles_page` pagination upstream; hubs use `/page/{n}/`.
Required: path. Optional: page.
Sampled 14 Oct 2026: 15 items. Filled in every item: title, url, published_at, image_url. In the sample: published_at: October 6, 2026 (4), October 9, 2026 (3), September 30, 2026 (3) and 2 more; url: editorial.rottentomatoes.com; title: median 42 characters; image_url: editorial.rottentomatoes.com.
Open in Playground
GET/rottentomatoes/editorial/taxonomiesapiKey1 credit/request
Returns the complete set of public editorial term vocabularies accepted by the term discovery endpoint, with the content types each taxonomy filters.
Takes no parameters.
Sampled 14 Oct 2026: 10 items. Filled in every item: value, label, types, hierarchical. In the sample: value: “categories” and 9 other values; hierarchical: true in 1 of 10; types: median 6 entries; label: “Categories” and 9 other values.
Open in Playground
GET/rottentomatoes/editorial/termsapiKey2 credits/request
Pages public terms from one discovered editorial taxonomy. All taxonomy values are listed by `/rottentomatoes/editorial/taxonomies`; `parent` is accepted only for `categories`, while `offset` is supported by all other taxonomies.
Required: taxonomy (10 allowed values: categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors). Optional: search, page, limit, hide_empty, order (2 allowed values: asc, desc), orderby (8 allowed values: id, include, name, slug, include_slugs, term_group, description, count), include, exclude, slug, post, offset, parent.
Sampled 14 Oct 2026: 1 item. Filled in every item: id, count, name, slug, link. In the sample: name: “RT Staff”; link: editorial.rottentomatoes.com.
Open in Playground
GET/rottentomatoes/editorial/typesapiKey1 credit/request
Lists the editorial content types Rotten Tomatoes accepts as `type` on its editorial content endpoint, each with a `value` and `label` (for example `article`, `guide`, `gallery`, `rt-hub` and `pages`). The set was last verified on 2026-09-26, shown in `verified_at`. The `pages` type returns metadata and permalinks, not page bodies.
Takes no parameters.
Sampled 14 Oct 2026: 11 items. Filled in every item: value, label. In the sample: value: “article” and 10 other values; label: “Articles” and 10 other values.
Open in Playground
GET/rottentomatoes/episodeapiKey3 credits/request
Returns Rotten Tomatoes TV episode metadata, scorecard data, parent series/season metadata, and public video metadata. Pass exactly one of `path` or `url`.
Optional: path, url.
Sampled 14 Oct 2026: 6 items. Filled in every item: name, url, image_url. In the sample: name: “Bryan Cranston” and 5 other values; url: rottentomatoes.com; image_url: resizing.flixster.com.
Open in Playground
GET/rottentomatoes/movieapiKey3 credits/request
Returns Rotten Tomatoes movie metadata, scorecard data, and representative audience reviews. Pass exactly one of `path` or `url`.
Optional: path, url.
Sampled 14 Oct 2026: 6 items. Filled in every item: display_name, display_date, rating, rating_range, rating_id, review, verified, fandango_review. In the sample: display_date: “Mar 19, 2026” and 3 other values; verified: true in 6 of 6; review: “Watching this movie with the beautiful Rena!” and 5 other values; fandango_review: true in 6 of 6.
Open in Playground
GET/rottentomatoes/movie/reviewsapiKey3 credits/request
Returns Rotten Tomatoes movie reviews, newest first. All four `type` values return the full review feed in one request: each review carries a stable `id`, ISO `created_at`/`updated_at` timestamps, the critic identity and the original article URL, and the list is pageable `limit` reviews at a time: pass `data.page_info.end_cursor` back as `after` for the next page and keep `limit` the same while paging. `data.transport` is `feed_api` for that path. A title with no reviews yet, or a top-critics or audience list that is still empty, returns 200 with an empty `reviews` array. If the feed cannot be read the service loads the movie's own review page the way a visitor's browser does and reads the list that page receives (`transport: browser_render`, slower, at most five pages); if that also fails for the first page, the movie page's embedded sample of about 6 reviews is served with `render_error` set (`transport: public_page`) and the call is not charged. `data.subject.kind` is `movie`, and `data.movie` remains present for compatibility. `data.fetched_at` and the `X-Cache` and `X-Availability-Last-Success-*` response headers show how fresh the data is. Pass exactly one of `path` or `url`. Supported `type` values are `critics`, `top-critics`, `audience`, and `verified-audience`.
Optional: path, url, type (4 allowed values: critics, top-critics, audience, verified-audience), limit, after.
Sampled 14 Oct 2026: 6 items. Filled in every item: type, display_name, publication, created_at, review, score_sentiment, top_review, top_critic and 9 more. Not in every item: original_score (2). In the sample: critic_url: rottentomatoes.com; top_review: true in 0 of 6; review: median 116 characters; top_critic: true in 1 of 6; top_publication: true in 3 of 6; tomatometer_approved: true in 3 of 6; publication_approved: true in 4 of 6; verified: true in 0 of 6.
Open in Playground
GET/rottentomatoes/moviesapiKey5 credits/request
Returns the details of up to 20 Rotten Tomatoes movies in one call, in the order requested. Each entry carries the title, synopsis, path and URL, `ems_id`, runtime, release date/year, production companies, the release runs with distributors, the Tomatometer and Popcornmeter scores, the score variants for all critics, top critics, all audience and verified audience, the critics and audience consensus, and `where_to_watch`: the public streaming, rental and purchase offers with provider name, link, licence, quality, price and availability date. Those are public provider pages, not playable media URLs. Identifiers that resolve to nothing are listed in `data.not_found` instead of failing the call. Pass exactly one of `ids` (Rotten Tomatoes `ems_id` values) or `paths` (Rotten Tomatoes movie paths or URLs); the `paths` form resolves each path first, so it costs one extra upstream read per path. The headline Tomatometer and Popcornmeter carry no counts; review and rating counts are in the score variants (for the number of critic reviews read `scores.critics_all.review_count`). Review samples are not returned here: use `/rottentomatoes/movie/reviews` for reviews. `data.fetched_at` is the UTC fetch time.
Optional: ids, paths.
Open in Playground
GET/rottentomatoes/personapiKey3 credits/request
Returns Rotten Tomatoes celebrity/person metadata and filmography rows. Pass exactly one of `path` or `url`.
Optional: path, url, media_type (2 allowed values: movie, tv), sort (6 allowed values: newest, oldest, audience_highest, audience_lowest, critic_highest, critic_lowest), after, limit.
Sampled 14 Oct 2026: 24 items. Filled in every item: position, title, path, url, years_featured, credits. Not in every item: poster_url (23), critics_score (19), audience_score (23). In the sample: position: 1 to 24, median 12; url: rottentomatoes.com; poster_url: resizing.flixster.com; years_featured: 1,997 to 2,026, median 2,014.
Open in Playground
GET/rottentomatoes/publicationapiKey3 credits/request
Returns one Rotten Tomatoes publication: its name, encrypted id, editorial page, image, whether it is a top publication and Tomatometer approved, its follower and review counts, and the critics who write for it with their names, encrypted ids, profile URLs and top-critic flags. Take the `id` from `encrypted_publication_id` (or `publication_id`) on any review row returned by the review endpoints. `data.fetched_at` is the UTC fetch time.
Required: id.
Open in Playground
GET/rottentomatoes/publication/reviewsapiKey3 credits/request
Returns the critic reviews one Rotten Tomatoes publication has published, newest first: stable review ids, ISO `created_at`/`updated_at` times, the critic identity, the publication name, the quote, the score sentiment and the original article URL. Pass `data.page_info.end_cursor` back as `after` for the next page, with the same `limit` (max 20). `data.subject.kind` is `publication` and `data.subject.title` is the outlet's name. An empty list is a `200` with no reviews. The `id` must be the encrypted publication id (`encrypted_publication_id` on any review row); a numeric id is rejected. `data.fetched_at` is the UTC fetch time.
Required: id. Optional: limit, after.
Open in Playground
GET/rottentomatoes/searchapiKey2 credits/request
Searches Rotten Tomatoes movies by the required `query`, returning up to `limit` rows (default 10, max 20). Each row has the title, URL, release year or start and end year, `tomatometer_score` and sentiment, `certified_fresh`, cast and image. No matches returns an empty `results` array.
Required: query. Optional: limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: title, path, url, image_url, cast, release_year, certified_fresh. Not in every item: tomatometer_score (6), tomatometer_sentiment (6). In the sample: tomatometer_sentiment: NEGATIVE (4), POSITIVE (2); release_year: 1,999 to 2,019, median 2,010; title: “Inception” and 9 other values; url: rottentomatoes.com; certified_fresh: true in 1 of 10; path: “/m/inception” and 9 other values; image_url: resizing.flixster.com; cast: “Leonardo DiCaprio,Joseph Gordon-Levitt,Elliot Page” and 9 other values.
Open in Playground
GET/rottentomatoes/seasonapiKey3 credits/request
Returns Rotten Tomatoes TV season metadata, scorecard data, parent series metadata, and episode rows. Pass exactly one of `path` or `url`.
Optional: path, url.
Sampled 14 Oct 2026: 7 items. Filled in every item: episode_number, title, path, url, air_date, description. In the sample: air_date: 2008-01-20 to 2008-03-09; episode_number: 1 to 7, median 4; title: “Pilot” and 6 other values; url: rottentomatoes.com; description: median 132 characters; path: “/tv/breaking_bad/s01/e01” and 6 other values.
Open in Playground
GET/rottentomatoes/seriesapiKey3 credits/request
Returns Rotten Tomatoes TV series metadata and scorecard data. Pass exactly one of `path` or `url`.
Optional: path, url.
Sampled 14 Oct 2026: 5 items. Filled in every item: name, url, image_url. In the sample: name: “Bryan Cranston” and 4 other values; url: rottentomatoes.com; image_url: resizing.flixster.com.
Open in Playground
GET/rottentomatoes/sitemap/urlsapiKey3 credits/request
Returns a page of URLs from one child sitemap. Discover valid `name` values with `rottentomatoes-sitemaps`; use offset/limit to page through the complete sitemap.
Required: name. Optional: offset, limit.
Sampled 14 Oct 2026: 40 items. Filled in every item: url. In the sample: url: rottentomatoes.com.
Open in Playground
GET/rottentomatoes/sitemapsapiKey2 credits/request
Returns the live sitemap index and every named child sitemap, including movie, TV series, season, episode, person, critic, publication, browse-list, and static route inventories.
Takes no parameters.
Sampled 14 Oct 2026: 157 items. Filled in every item: name, family, index, url, last_modified. In the sample: last_modified: 2025-11-12; name: “static_0” and 156 other values; url: rottentomatoes.com; family: “static” and 11 other values.
Open in Playground