Rotten Tomatoes API endpoint
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.
/rottentomatoes/browse/filtersReturns the live filters and full accepted value space rendered by one public
Rotten Tomatoes browse page. Values are scoped to the selected list and can
change over time. The current observed lists are movies_in_theaters,
movies_at_home, movies_coming_soon, and tv_series_browse.
Query parameters:
list: browse list, default movies_in_theaters; allowed values are
movies_in_theaters, movies_at_home, movies_coming_soon, and
tv_series_browse.The response's filters array contains filter keys (sort, genres,
ratings, audience, critics, and, on selected lists, affiliates) and each
current value with its display label. Use only values returned for the chosen
list. The endpoint reads the public page menus and requires no account or key
at Rotten Tomatoes.
| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| key | 6 | |
| label | 6 | “Sort” and 5 other values |
| values | 6 | median 7 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| list | string | No | Browse list: movies_in_theaters, movies_at_home, movies_coming_soon, tv_series_browse Allowed values: movies_in_theaters, movies_at_home, movies_coming_soon, tv_series_browse. | movies_in_theaters | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/browse/filters?list=movies_in_theaters" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"list": "movies_in_theaters",
"filters": [
{
"key": "sort",
"label": "Sort By",
"values": [
{
"value": "popular",
"label": "Most Popular"
}
]
},
{
"key": "genres",
"label": "Genre",
"values": [
{
"value": "action",
"label": "Action"
}
]
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/rottentomatoes.browseFiltersResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | rottentomatoes.BrowseFiltersResponse | No | ||||
| data.fetched_at | string | No | 2026-09-26T10:00:00Z | |||
| data.filters | array | No | ||||
| data.filters[].key | string | No | genres | |||
| data.filters[].label | string | No | Genre | |||
| data.filters[].values | array | No | ||||
| data.filters[].values[].label | string | No | Action | |||
| data.filters[].values[].value | string | No | action | |||
| data.list | string | No | movies_in_theaters | |||
| data.public_page_derived | boolean | No | true | |||
| data.source_url | string | No | https://www.rottentomatoes.com/browse/movies_in_theaters/sort:popular | |||
| 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/browse/filters?list=movies_in_theaters" \
-H "x-api-key: $CRAWLORA_API_KEY"