Rotten Tomatoes API endpoint
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}/`.
/rottentomatoes/editorial/sectionReturns the rendered article cards from a public Rotten Tomatoes Editorial section archive, RT hub, or hub subpage. Discover archive paths through the pages, rt-hub, and hub-subpage collections on /api/v1/rottentomatoes/editorial/content.
Query parameters:
path (required): a discovered path such as /countdown/, /rt-hub/what-to-watch/, or /hub-subpage/best-popular/.page: one-based page number, default 1. Static sections use the site's articles_page pagination; RT hubs and hub subpages use /page/{n}/.The response includes the archive title, current page, total page count, and visible cards with title, URL, publication date, and image URL when present. A page beyond the upstream archive's final page returns not found. Results are derived from the public section HTML.
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| title | 15 | median 42 characters |
| url | 15 | editorial.rottentomatoes.com |
| published_at | 15 | October 6, 2026 (4), October 9, 2026 (3), September 30, 2026 (3) and 2 more |
| image_url | 15 | editorial.rottentomatoes.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| path | string | Yes | Discovered editorial section path | /countdown/ | |
| page | integer | No | One-based page, default 1 | 2 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/section?path=%2Fcountdown%2F&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"path": "/countdown/",
"title": "Countdown",
"page": 1,
"total_pages": 40,
"has_next_page": true,
"results": [
{
"title": "The Best Movies of 2026, Ranked",
"url": "https://editorial.rottentomatoes.com/guide/best-movies-2026/",
"published_at": "September 25, 2026",
"image_url": "https://editorial.rottentomatoes.com/wp-content/uploads/2026/04/poster.png?w=300"
}
],
"source_url": "https://editorial.rottentomatoes.com/countdown/",
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/rottentomatoes.editorialSectionResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | rottentomatoes.EditorialSectionResponse | No | ||||
| data.fetched_at | string | No | 2026-09-26T10:00:00Z | |||
| data.has_next_page | boolean | No | true | |||
| data.page | integer | No | 1 | |||
| data.path | string | No | /countdown/ | |||
| data.public_page_derived | boolean | No | true | |||
| data.results | array | No | ||||
| data.results[].image_url | string | No | https://editorial.rottentomatoes.com/wp-content/uploads/2026/04/poster.png?w=300 | |||
| data.results[].published_at | string | No | September 25, 2026 | |||
| data.results[].title | string | No | Robert Pattinson Movies Ranked by Tomatometer | |||
| data.results[].url | string | No | https://editorial.rottentomatoes.com/guide/robert-pattinson/ | |||
| data.source_url | string | No | https://editorial.rottentomatoes.com/countdown/ | |||
| data.title | string | No | Countdown | |||
| data.total_pages | integer | No | 40 | |||
| msg | string | No | OK |
| 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 |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/section?path=%2Fcountdown%2F&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"