Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes Editorial Content API

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.

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.editorialContentResponseDoc/rottentomatoes/editorial/content

Endpoint facts

Method: GET
API path: /rottentomatoes/editorial/content
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Rotten Tomatoes
Response schema: #/definitions/rottentomatoes.editorialContentResponseDoc

Rotten Tomatoes Scraper API Try Rotten Tomatoes Editorial Content API in Playground Rotten Tomatoes API documentation

How this endpoint behaves

Query parameters:

type required. Accepted values: article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, pages. Discover the values from /api/v1/rottentomatoes/editorial/types. pages lists 61 public page records, including editorial section and campaign indexes; returned row type is page.
query optional text filter, maximum 200 bytes.
page optional one-based page from 1 to 10000, default 1.
limit optional rows per page from 1 to 100, default 20.
taxonomy and term_ids are optional but must be provided together. Accepted taxonomy values: categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors. Discover which editorial type supports each taxonomy from /api/v1/rottentomatoes/editorial/taxonomies; unsupported type/taxonomy combinations are rejected.
term_ids is a comma-separated list of positive term IDs from /api/v1/rottentomatoes/editorial/terms.
operator is OR (default) or AND; it controls whether a record needs any or all selected terms.
include_children is supported only with taxonomy=categories; default false matches only the selected categories.

Notable response behavior:

Reads the selected public collection from the anonymous WordPress REST API.
The pages collection exposes public section page IDs, titles, and URLs. One legacy page links to www.rottentomatoes.com; that official host is normalized to HTTPS.
Can filter the collection by a discovered taxonomy and one or more discovered term IDs; filtered result rows include the matching term_ids.
Includes title, safe Rotten Tomatoes editorial permalink, publication and modification times, excerpt, author ID, and featured media ID when available.
Empty results with total: 0 is a valid no-results response. Missing or invalid pagination headers, rows with another type, and links outside the editorial host are upstream errors.
The upstream X-WP-Total and X-WP-TotalPages headers provide pagination metadata. has_next_page is derived from the requested page and total page count.

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/editorial/content?limit=20&query=countdown&type=pages
Items in results: 2
Fields filled in every checked item: 7

Field	Filled in, of 2 checked	Values in the sample
id	2
type	2	“page”
title	2	median 9 characters
url	2	editorial.rottentomatoes.com
published_at	2	2015-10-28 to 2016-04-19
modified_at	2	2026-01-23 to 2026-01-26
author_id	2

Request parameters

Parameter	Type	Required	Description	Example
type	string	Yes	Editorial content type Allowed values: article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, pages.	guide
query	string	No	Optional text filter; maximum 200 bytes	horror
page	integer	No	One-based result page from 1 to 10000; default 1	1
limit	integer	No	Rows per page, default 20, range 1 to 100	20
taxonomy	string	No	Optional editorial taxonomy; discover type support from /rottentomatoes/editorial/taxonomies 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.	related-movie-id
term_ids	string	No	Comma-separated positive term IDs; required with taxonomy	121877,121876
operator	string	No	Whether any or all selected terms must match; default OR Allowed values: AND, OR.	OR
include_children	boolean	No	For categories only, include child categories; default false	false
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/content?type=guide&query=coffee&page=1&limit=10&taxonomy=categories&operator=AND&include_children=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": "guide",
    "query": "horror",
    "taxonomy": "related-movie-id",
    "term_ids": [
      121877,
      121876
    ],
    "operator": "OR",
    "page": 1,
    "limit": 2,
    "total": 22,
    "total_pages": 11,
    "has_next_page": true,
    "results": [
      {
        "id": 162290,
        "type": "guide",
        "title": "Brad Pitt Movies Ranked by Tomatometer",
        "url": "https://editorial.rottentomatoes.com/guide/all-brad-pitt-movies-ranked-by-tomatometer/",
        "published_at": "2026-09-25T08:55:34",
        "modified_at": "2026-09-25T08:55:35",
        "excerpt": "Pitt’s biggest movies, including ‘Fight Club’, ‘Moneyball’, ‘Once Upon a Time in Hollywood!’",
        "author_id": 12,
        "featured_media_id": 297818,
        "term_ids": [
          121877,
          121876,
          121828
        ]
      }
    ],
    "source_url": "https://editorial.rottentomatoes.com/wp-json/wp/v2/guide?_fields=id%2Ctype%2Cdate%2Cmodified%2Cslug%2Clink%2Ctitle%2Cexcerpt%2Cauthor%2Cfeatured_media%2Crelated-movie-id&page=1&per_page=2&related-movie-id%5Boperator%5D=OR&related-movie-id%5Bterms%5D%5B%5D=121877&related-movie-id%5Bterms%5D%5B%5D=121876&search=horror",
    "fetched_at": "2026-09-26T10:00:00Z",
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.editorialContentResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	rottentomatoes.EditorialContentResponse	No
data.fetched_at	string	No		2026-09-26T10:00:00Z
data.has_next_page	boolean	No		true
data.limit	integer	No		20
data.operator	string	No	AND, OR	OR
data.page	integer	No		1
data.public_page_derived	boolean	No		true
data.query	string	No		horror
data.results	array	No
data.results[].author_id	integer	No		944
data.results[].excerpt	string	No		A ranked guide to essential 21st century biopics.
data.results[].featured_media_id	integer	No		297622
data.results[].id	integer	No		297618
data.results[].modified_at	string	No		2026-09-25T09:04:07
data.results[].published_at	string	No		2026-09-25T09:04:07
data.results[].term_ids	array	No		121877,121876
data.results[].title	string	No		Essential 21st Century Biopics Ranked
data.results[].type	string	No	article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, page	guide
data.results[].url	string	No		https://editorial.rottentomatoes.com/guide/essential-21st-century-biopic-movies/
data.source_url	string	No		https://editorial.rottentomatoes.com/wp-json/wp/v2/guide?page=1&per_page=20
data.taxonomy	string	No	categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors	related-movie-id
data.term_ids	array	No		121877,121876
data.total	integer	No		1194
data.total_pages	integer	No		60
data.type	string	No	article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, pages	guide
msg	string	No		OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/content?type=guide&query=coffee&page=1&limit=10&taxonomy=categories&operator=AND&include_children=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Rotten Tomatoes endpoint docs Rotten Tomatoes Scraper API Rotten Tomatoes browse filters API documentation Rotten Tomatoes movie discovery rows API documentation Rotten Tomatoes TV discovery rows API documentation Rotten Tomatoes critic publications API documentation Rotten Tomatoes Critics Directory API documentation Rotten Tomatoes Editorial Detail API documentation

Open in Playground Back to group

Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes Editorial Content API

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.editorialContentResponseDoc/rottentomatoes/editorial/content

Endpoint facts

Method: GET
API path: /rottentomatoes/editorial/content
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Rotten Tomatoes
Response schema: #/definitions/rottentomatoes.editorialContentResponseDoc

Rotten Tomatoes Scraper API Try Rotten Tomatoes Editorial Content API in Playground Rotten Tomatoes API documentation

How this endpoint behaves

Query parameters:

type required. Accepted values: article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, pages. Discover the values from /api/v1/rottentomatoes/editorial/types. pages lists 61 public page records, including editorial section and campaign indexes; returned row type is page.
query optional text filter, maximum 200 bytes.
page optional one-based page from 1 to 10000, default 1.
limit optional rows per page from 1 to 100, default 20.
taxonomy and term_ids are optional but must be provided together. Accepted taxonomy values: categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors. Discover which editorial type supports each taxonomy from /api/v1/rottentomatoes/editorial/taxonomies; unsupported type/taxonomy combinations are rejected.
term_ids is a comma-separated list of positive term IDs from /api/v1/rottentomatoes/editorial/terms.
operator is OR (default) or AND; it controls whether a record needs any or all selected terms.
include_children is supported only with taxonomy=categories; default false matches only the selected categories.

Notable response behavior:

Reads the selected public collection from the anonymous WordPress REST API.
The pages collection exposes public section page IDs, titles, and URLs. One legacy page links to www.rottentomatoes.com; that official host is normalized to HTTPS.
Can filter the collection by a discovered taxonomy and one or more discovered term IDs; filtered result rows include the matching term_ids.
Includes title, safe Rotten Tomatoes editorial permalink, publication and modification times, excerpt, author ID, and featured media ID when available.
Empty results with total: 0 is a valid no-results response. Missing or invalid pagination headers, rows with another type, and links outside the editorial host are upstream errors.
The upstream X-WP-Total and X-WP-TotalPages headers provide pagination metadata. has_next_page is derived from the requested page and total page count.

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/editorial/content?limit=20&query=countdown&type=pages
Items in results: 2
Fields filled in every checked item: 7

Field	Filled in, of 2 checked	Values in the sample
id	2
type	2	“page”
title	2	median 9 characters
url	2	editorial.rottentomatoes.com
published_at	2	2015-10-28 to 2016-04-19
modified_at	2	2026-01-23 to 2026-01-26
author_id	2

Request parameters

Parameter	Type	Required	Description	Example
type	string	Yes	Editorial content type Allowed values: article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, pages.	guide
query	string	No	Optional text filter; maximum 200 bytes	horror
page	integer	No	One-based result page from 1 to 10000; default 1	1
limit	integer	No	Rows per page, default 20, range 1 to 100	20
taxonomy	string	No	Optional editorial taxonomy; discover type support from /rottentomatoes/editorial/taxonomies 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.	related-movie-id
term_ids	string	No	Comma-separated positive term IDs; required with taxonomy	121877,121876
operator	string	No	Whether any or all selected terms must match; default OR Allowed values: AND, OR.	OR
include_children	boolean	No	For categories only, include child categories; default false	false
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/content?type=guide&query=coffee&page=1&limit=10&taxonomy=categories&operator=AND&include_children=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": "guide",
    "query": "horror",
    "taxonomy": "related-movie-id",
    "term_ids": [
      121877,
      121876
    ],
    "operator": "OR",
    "page": 1,
    "limit": 2,
    "total": 22,
    "total_pages": 11,
    "has_next_page": true,
    "results": [
      {
        "id": 162290,
        "type": "guide",
        "title": "Brad Pitt Movies Ranked by Tomatometer",
        "url": "https://editorial.rottentomatoes.com/guide/all-brad-pitt-movies-ranked-by-tomatometer/",
        "published_at": "2026-09-25T08:55:34",
        "modified_at": "2026-09-25T08:55:35",
        "excerpt": "Pitt’s biggest movies, including ‘Fight Club’, ‘Moneyball’, ‘Once Upon a Time in Hollywood!’",
        "author_id": 12,
        "featured_media_id": 297818,
        "term_ids": [
          121877,
          121876,
          121828
        ]
      }
    ],
    "source_url": "https://editorial.rottentomatoes.com/wp-json/wp/v2/guide?_fields=id%2Ctype%2Cdate%2Cmodified%2Cslug%2Clink%2Ctitle%2Cexcerpt%2Cauthor%2Cfeatured_media%2Crelated-movie-id&page=1&per_page=2&related-movie-id%5Boperator%5D=OR&related-movie-id%5Bterms%5D%5B%5D=121877&related-movie-id%5Bterms%5D%5B%5D=121876&search=horror",
    "fetched_at": "2026-09-26T10:00:00Z",
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.editorialContentResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	rottentomatoes.EditorialContentResponse	No
data.fetched_at	string	No		2026-09-26T10:00:00Z
data.has_next_page	boolean	No		true
data.limit	integer	No		20
data.operator	string	No	AND, OR	OR
data.page	integer	No		1
data.public_page_derived	boolean	No		true
data.query	string	No		horror
data.results	array	No
data.results[].author_id	integer	No		944
data.results[].excerpt	string	No		A ranked guide to essential 21st century biopics.
data.results[].featured_media_id	integer	No		297622
data.results[].id	integer	No		297618
data.results[].modified_at	string	No		2026-09-25T09:04:07
data.results[].published_at	string	No		2026-09-25T09:04:07
data.results[].term_ids	array	No		121877,121876
data.results[].title	string	No		Essential 21st Century Biopics Ranked
data.results[].type	string	No	article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, page	guide
data.results[].url	string	No		https://editorial.rottentomatoes.com/guide/essential-21st-century-biopic-movies/
data.source_url	string	No		https://editorial.rottentomatoes.com/wp-json/wp/v2/guide?page=1&per_page=20
data.taxonomy	string	No	categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors	related-movie-id
data.term_ids	array	No		121877,121876
data.total	integer	No		1194
data.total_pages	integer	No		60
data.type	string	No	article, guide, gallery, hub-subpage, non-rt-publication, rt-hub, how-to, otg-article, prev, rt_poll, pages	guide
msg	string	No		OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/content?type=guide&query=coffee&page=1&limit=10&taxonomy=categories&operator=AND&include_children=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Rotten Tomatoes Editorial Content API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Rotten Tomatoes Editorial Content API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related