Rotten Tomatoes API endpoint
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.
/rottentomatoes/sitemap/urlsReturns a page of public Rotten Tomatoes URLs from one child sitemap discovered
through /rottentomatoes/sitemaps.
Query parameters:
name: required sitemap name from the sitemap index, such as movie_0.offset: zero-based row offset, default 0.limit: rows per response, default 100, maximum 500.URLs disallowed by Rotten Tomatoes' robots rules are excluded, including movie
and TV picture galleries, search, critic self-submission, and account paths.
total is the eligible row count after this exclusion; use offset to page
through the result.
| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| url | 40 | rottentomatoes.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| name | string | Yes | Sitemap name returned by /rottentomatoes/sitemaps | movie_0 | |
| offset | integer | No | Zero-based offset, default 0 | 0 | |
| limit | integer | No | URLs to return, default 100, max 500 | 100 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/sitemap/urls?name=movie_0&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"name": "movie_0",
"total": 12000,
"offset": 0,
"limit": 2,
"urls": [
{
"url": "https://www.rottentomatoes.com/m/example_movie",
"last_modified": "2025-11-12"
}
],
"has_more": true,
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/rottentomatoes.sitemapURLResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | rottentomatoes.SitemapURLResponse | No | ||||
| data.fetched_at | string | No | 2026-09-26T10:00:00Z | |||
| data.has_more | boolean | No | true | |||
| data.limit | integer | No | 100 | |||
| data.name | string | No | movie_0 | |||
| data.offset | integer | No | 0 | |||
| data.public_page_derived | boolean | No | true | |||
| data.source_url | string | No | https://www.rottentomatoes.com/sitemaps/movie_0.xml | |||
| data.total | integer | No | 16750 | |||
| data.urls | array | No | ||||
| data.urls[].last_modified | string | No | 2025-11-12 | |||
| data.urls[].url | string | No | https://www.rottentomatoes.com/m/inception | |||
| 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/sitemap/urls?name=movie_0&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"