Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes Editorial Terms API

Pages public terms from one discovered editorial taxonomy. All taxonomy values are listed by `/rottentomatoes/editorial/taxonomies`; `parent` is accepted only for `categories`, while `offset` is supported by all other taxonomies.

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.editorialTermsResponseDoc/rottentomatoes/editorial/terms

Endpoint facts

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

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

How this endpoint behaves

Lists one page of terms from a public Editorial vocabulary. Discover every supported taxonomy and its applicable content types from /rottentomatoes/editorial/taxonomies. Search, sort, and page through large sets; hide_empty=true limits results to terms assigned to published content.

Query parameters:

taxonomy (required): one of categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors.
search: optional name search, up to 200 bytes.
page: one-based page, default 1, range 1 to 10000.
limit: terms per page, default 20, range 1 to 100.
hide_empty: when true, omit terms with no assigned content; default false returns the full vocabulary, including unused terms.
order: asc or desc.
orderby: id, include, name, slug, include_slugs, term_group, description, or count.
include: comma-separated positive term IDs to include.
exclude: comma-separated positive term IDs to exclude.
slug: one slug or comma-separated slugs.
post: filter to terms assigned to a content record ID.
offset: zero-based offset for all taxonomies except categories.
parent: category parent ID; accepted only for categories and omitted by default so every category level remains discoverable.

The taxonomy set was live-checked against the public WordPress registry. categories currently has one top-level value (Uncategorized); each of the other vocabularies is larger and is paginated. Some related movie/TV/celebrity terms have a zero content count, so keep the default hide_empty=false when discovering the full accepted value space.

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/editorial/terms?limit=20&search=RT+Staff&taxonomy=coauthors
Items in results: 1
Fields filled in every checked item: 5

Field	Filled in, of 1 checked	Values in the sample
id	1
count	1	3,071
name	1	“RT Staff”
slug	1
link	1	editorial.rottentomatoes.com

Request parameters

Parameter	Type	Required	Description	Example
taxonomy	string	Yes	Editorial taxonomy value 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.	coauthors
search	string	No	Optional term search; maximum 200 bytes	RT Staff
page	integer	No	One-based page, default 1	1
limit	integer	No	Terms per page, default 20, range 1 to 100	20
hide_empty	boolean	No	When true, omit terms with no assigned content	true
order	string	No	Term sort direction Allowed values: asc, desc.	desc
orderby	string	No	Term sort key Allowed values: id, include, name, slug, include_slugs, term_group, description, count.	count
include	string	No	Comma-separated positive term IDs to include	10732,10733
exclude	string	No	Comma-separated positive term IDs to exclude	10733
slug	string	No	Optional term slug or comma-separated slugs	cap-rt-staff
post	integer	No	Filter to terms assigned to this content record	297765
offset	integer	No	Zero-based offset; accepted except for categories	100
parent	integer	No	Category parent ID; accepted only for categories	0
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/terms?taxonomy=coauthors&page=1&limit=10&hide_empty=true&order=asc&orderby=id" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "taxonomy": "coauthors",
    "page": 1,
    "limit": 2,
    "total": 927,
    "total_pages": 464,
    "has_next_page": true,
    "results": [
      {
        "id": 10732,
        "count": 3072,
        "name": "RT Staff",
        "slug": "cap-rt-staff",
        "link": "https://editorial.rottentomatoes.com/author/cap-rt-staff/"
      },
      {
        "id": 10733,
        "count": 52,
        "name": "marya.gates",
        "slug": "cap-marya-gates",
        "link": "https://editorial.rottentomatoes.com/author/cap-marya-gates/"
      }
    ],
    "source_url": "https://editorial.rottentomatoes.com/wp-json/wp/v2/coauthors?hide_empty=false&page=1&per_page=2",
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.editorialTermsResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	rottentomatoes.EditorialTermsResponse	No
data.fetched_at	string	No		2026-09-26T10:00:00Z
data.has_next_page	boolean	No		true
data.limit	integer	No		20
data.page	integer	No		1
data.public_page_derived	boolean	No		true
data.results	array	No
data.results[].count	integer	No		3072
data.results[].description	string	No
data.results[].id	integer	No		10732
data.results[].link	string	No		https://editorial.rottentomatoes.com/author/cap-rt-staff/
data.results[].name	string	No		RT Staff
data.results[].parent	integer	No		0
data.results[].slug	string	No		cap-rt-staff
data.search	string	No		RT Staff
data.source_url	string	No		https://editorial.rottentomatoes.com/wp-json/wp/v2/coauthors?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	coauthors
data.total	integer	No		927
data.total_pages	integer	No		47
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/terms?taxonomy=coauthors&page=1&limit=10&hide_empty=true&order=asc&orderby=id" \
  -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 Terms API

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.editorialTermsResponseDoc/rottentomatoes/editorial/terms

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

taxonomy (required): one of categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors.
search: optional name search, up to 200 bytes.
page: one-based page, default 1, range 1 to 10000.
limit: terms per page, default 20, range 1 to 100.
hide_empty: when true, omit terms with no assigned content; default false returns the full vocabulary, including unused terms.
order: asc or desc.
orderby: id, include, name, slug, include_slugs, term_group, description, or count.
include: comma-separated positive term IDs to include.
exclude: comma-separated positive term IDs to exclude.
slug: one slug or comma-separated slugs.
post: filter to terms assigned to a content record ID.
offset: zero-based offset for all taxonomies except categories.
parent: category parent ID; accepted only for categories and omitted by default so every category level remains discoverable.

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/editorial/terms?limit=20&search=RT+Staff&taxonomy=coauthors
Items in results: 1
Fields filled in every checked item: 5

Field	Filled in, of 1 checked	Values in the sample
id	1
count	1	3,071
name	1	“RT Staff”
slug	1
link	1	editorial.rottentomatoes.com

Request parameters

Parameter	Type	Required	Description	Example
taxonomy	string	Yes	Editorial taxonomy value 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.	coauthors
search	string	No	Optional term search; maximum 200 bytes	RT Staff
page	integer	No	One-based page, default 1	1
limit	integer	No	Terms per page, default 20, range 1 to 100	20
hide_empty	boolean	No	When true, omit terms with no assigned content	true
order	string	No	Term sort direction Allowed values: asc, desc.	desc
orderby	string	No	Term sort key Allowed values: id, include, name, slug, include_slugs, term_group, description, count.	count
include	string	No	Comma-separated positive term IDs to include	10732,10733
exclude	string	No	Comma-separated positive term IDs to exclude	10733
slug	string	No	Optional term slug or comma-separated slugs	cap-rt-staff
post	integer	No	Filter to terms assigned to this content record	297765
offset	integer	No	Zero-based offset; accepted except for categories	100
parent	integer	No	Category parent ID; accepted only for categories	0
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/editorial/terms?taxonomy=coauthors&page=1&limit=10&hide_empty=true&order=asc&orderby=id" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "taxonomy": "coauthors",
    "page": 1,
    "limit": 2,
    "total": 927,
    "total_pages": 464,
    "has_next_page": true,
    "results": [
      {
        "id": 10732,
        "count": 3072,
        "name": "RT Staff",
        "slug": "cap-rt-staff",
        "link": "https://editorial.rottentomatoes.com/author/cap-rt-staff/"
      },
      {
        "id": 10733,
        "count": 52,
        "name": "marya.gates",
        "slug": "cap-marya-gates",
        "link": "https://editorial.rottentomatoes.com/author/cap-marya-gates/"
      }
    ],
    "source_url": "https://editorial.rottentomatoes.com/wp-json/wp/v2/coauthors?hide_empty=false&page=1&per_page=2",
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.editorialTermsResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	rottentomatoes.EditorialTermsResponse	No
data.fetched_at	string	No		2026-09-26T10:00:00Z
data.has_next_page	boolean	No		true
data.limit	integer	No		20
data.page	integer	No		1
data.public_page_derived	boolean	No		true
data.results	array	No
data.results[].count	integer	No		3072
data.results[].description	string	No
data.results[].id	integer	No		10732
data.results[].link	string	No		https://editorial.rottentomatoes.com/author/cap-rt-staff/
data.results[].name	string	No		RT Staff
data.results[].parent	integer	No		0
data.results[].slug	string	No		cap-rt-staff
data.search	string	No		RT Staff
data.source_url	string	No		https://editorial.rottentomatoes.com/wp-json/wp/v2/coauthors?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	coauthors
data.total	integer	No		927
data.total_pages	integer	No		47
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/terms?taxonomy=coauthors&page=1&limit=10&hide_empty=true&order=asc&orderby=id" \
  -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 Terms 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 Terms API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related