Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes Editorial Detail API

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.

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.editorialDetailResponseDoc/rottentomatoes/editorial/detail

Endpoint facts

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

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

How this endpoint behaves

Returns full public Editorial article content. Discover a matching path through /api/v1/rottentomatoes/editorial/content; the endpoint accepts article, gallery, guide, on-the-go article, and preview paths. Non-Rotten-Tomatoes publication records use the public /article/{slug}/ page path.

Query parameters:

path (required): one discovered path shaped as /article/{slug}/, /gallery/{slug}/, /guide/{slug}/, /otg-article/{slug}/, or /prev/{slug}/.

Accepted content type values: article, gallery, guide, otg-article, prev.

The response includes the public .content-body HTML, readable paragraphs and headings, linked URLs, images, video embed URLs, article metadata, and the source URL. The HTML preserves Gutenberg and ranked-list markup for consumers that need the original structure. WordPress editorial polls, hubs, hub subpages, and section index pages are list/archive surfaces and are not accepted by this article-detail endpoint.

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/editorial/detail?path=%2Fguide%2Fall-brad-pitt-movies-ranked-by-tomatometer%2F
Items in links: 478
Fields filled in every checked item: 2

Field	Filled in, of 478 checked	Values in the sample
text	478	median 13 characters
url	478	rottentomatoes.com and 2 other hosts

Request parameters

Parameter	Type	Required	Default	Description	Example
path	string	Yes		Discovered Editorial content path	/guide/all-brad-pitt-movies-ranked-by-tomatometer/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/detail?path=%2Fguide%2Fall-brad-pitt-movies-ranked-by-tomatometer%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "path": "/guide/all-brad-pitt-movies-ranked-by-tomatometer/",
    "type": "guide",
    "title": "Brad Pitt Movies Ranked by Tomatometer",
    "subtitle": "We rank Brad Pitt movies by Tomatometer.",
    "body_html": "<h1 class=\"wp-block-heading\">Brad Pitt Movies, Ranked by Tomatometer</h1><p>...",
    "paragraphs": [
      "Brad Pitt and his trusty dog must survive the wilderness in Heart of the Beast.",
      "We are ranking all Brad Pitt movies by Tomatometer!"
    ],
    "headings": [
      "Brad Pitt Movies, Ranked by Tomatometer"
    ],
    "links": [
      {
        "text": "Brad Pitt",
        "url": "https://www.rottentomatoes.com/celebrity/brad_pitt"
      }
    ],
    "images": [
      "https://editorial.rottentomatoes.com/wp-content/uploads/2025/06/MCDHEOF_PA033-700x250-1.png?w=700"
    ],
    "video_urls": [
      "https://www.youtube-nocookie.com/embed/YGotImFPC24"
    ],
    "source_url": "https://editorial.rottentomatoes.com/guide/all-brad-pitt-movies-ranked-by-tomatometer/",
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.editorialDetailResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	rottentomatoes.EditorialDetailResponse	No
data.body_html	string	No
data.fetched_at	string	No
data.headings	array	No
data.image_url	string	No
data.images	array	No
data.links	array	No
data.links[].text	string	No
data.links[].url	string	No
data.modified_at	string	No
data.paragraphs	array	No
data.path	string	No		/guide/all-brad-pitt-movies-ranked-by-tomatometer/
data.public_page_derived	boolean	No
data.published_at	string	No
data.source_url	string	No
data.subtitle	string	No
data.title	string	No		Brad Pitt Movies Ranked by Tomatometer
data.type	string	No	article, gallery, guide, otg-article, prev	guide
data.video_urls	array	No
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/detail?path=%2Fguide%2Fall-brad-pitt-movies-ranked-by-tomatometer%2F" \
  -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 Content API documentation

Open in Playground Back to group

Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes Editorial Detail API

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.editorialDetailResponseDoc/rottentomatoes/editorial/detail

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

path (required): one discovered path shaped as /article/{slug}/, /gallery/{slug}/, /guide/{slug}/, /otg-article/{slug}/, or /prev/{slug}/.

Accepted content type values: article, gallery, guide, otg-article, prev.

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/editorial/detail?path=%2Fguide%2Fall-brad-pitt-movies-ranked-by-tomatometer%2F
Items in links: 478
Fields filled in every checked item: 2

Field	Filled in, of 478 checked	Values in the sample
text	478	median 13 characters
url	478	rottentomatoes.com and 2 other hosts

Request parameters

Parameter	Type	Required	Default	Description	Example
path	string	Yes		Discovered Editorial content path	/guide/all-brad-pitt-movies-ranked-by-tomatometer/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/detail?path=%2Fguide%2Fall-brad-pitt-movies-ranked-by-tomatometer%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "path": "/guide/all-brad-pitt-movies-ranked-by-tomatometer/",
    "type": "guide",
    "title": "Brad Pitt Movies Ranked by Tomatometer",
    "subtitle": "We rank Brad Pitt movies by Tomatometer.",
    "body_html": "<h1 class=\"wp-block-heading\">Brad Pitt Movies, Ranked by Tomatometer</h1><p>...",
    "paragraphs": [
      "Brad Pitt and his trusty dog must survive the wilderness in Heart of the Beast.",
      "We are ranking all Brad Pitt movies by Tomatometer!"
    ],
    "headings": [
      "Brad Pitt Movies, Ranked by Tomatometer"
    ],
    "links": [
      {
        "text": "Brad Pitt",
        "url": "https://www.rottentomatoes.com/celebrity/brad_pitt"
      }
    ],
    "images": [
      "https://editorial.rottentomatoes.com/wp-content/uploads/2025/06/MCDHEOF_PA033-700x250-1.png?w=700"
    ],
    "video_urls": [
      "https://www.youtube-nocookie.com/embed/YGotImFPC24"
    ],
    "source_url": "https://editorial.rottentomatoes.com/guide/all-brad-pitt-movies-ranked-by-tomatometer/",
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.editorialDetailResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	rottentomatoes.EditorialDetailResponse	No
data.body_html	string	No
data.fetched_at	string	No
data.headings	array	No
data.image_url	string	No
data.images	array	No
data.links	array	No
data.links[].text	string	No
data.links[].url	string	No
data.modified_at	string	No
data.paragraphs	array	No
data.path	string	No		/guide/all-brad-pitt-movies-ranked-by-tomatometer/
data.public_page_derived	boolean	No
data.published_at	string	No
data.source_url	string	No
data.subtitle	string	No
data.title	string	No		Brad Pitt Movies Ranked by Tomatometer
data.type	string	No	article, gallery, guide, otg-article, prev	guide
data.video_urls	array	No
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/detail?path=%2Fguide%2Fall-brad-pitt-movies-ranked-by-tomatometer%2F" \
  -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 Detail 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 Detail API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related