vee3-io Rotten Tomatoes API

The rotten-tomatoes API from vee3-io — 10 operation(s) for rotten-tomatoes.

Operations 10

GET /v1/rotten-tomatoes/search Rotten Tomatoes search #
GET /v1/rotten-tomatoes/movies/{movie_slug} Rotten Tomatoes movie details #
GET /v1/rotten-tomatoes/movies/{movie_slug}/reviews Rotten Tomatoes movie reviews #
GET /v1/rotten-tomatoes/movies/{movie_slug}/cast-and-crew Rotten Tomatoes movie cast and crew #
GET /v1/rotten-tomatoes/tv/{tv_show_slug} Rotten Tomatoes TV show details #
GET /v1/rotten-tomatoes/tv/{tv_show_slug}/seasons/{season_number} Rotten Tomatoes TV show season #
GET /v1/rotten-tomatoes/tv/{tv_show_slug}/episodes/{season_number}/{episode_number} Rotten Tomatoes TV show episode #
GET /v1/rotten-tomatoes/tv/{tv_show_slug}/cast-and-crew Rotten Tomatoes TV show cast and crew #
GET /v1/rotten-tomatoes/tv/{tv_show_slug}/seasons/{season_number}/reviews Rotten Tomatoes TV season reviews #
GET /v1/rotten-tomatoes/celebrities/{celebrity_slug} Rotten Tomatoes celebrity details #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/vee3-io:vee3-io-rotten-tomatoes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

vee3-io-rotten-tomatoes-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Vee3 Io Rotten Tomatoes API
  version: 0.1.0
  description: 'Operations tagged rotten-tomatoes across 2 of this provider''s published API definitions: vee3-io.json, vee3-io-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: rotten-tomatoes
paths:
  /v1/rotten-tomatoes/search:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes search
      description: Search Rotten Tomatoes for movies, TV series, and celebrities.
      operationId: rotten_tomatoes_search_v1_rotten_tomatoes_search_get
      security:
      - HTTPBearer: []
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 256
          title: Query
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 50
            minimum: 1
          - type: 'null'
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Search V1 Rotten Tomatoes Search Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/movies/{movie_slug}:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes movie details
      description: Fetch Rotten Tomatoes metadata for a movie by slug.
      operationId: rotten_tomatoes_movie_details_v1_rotten_tomatoes_movies__movie_slug__get
      security:
      - HTTPBearer: []
      parameters:
      - name: movie_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Movie Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Movie Details V1 Rotten Tomatoes Movies  Movie Slug  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/movies/{movie_slug}/reviews:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes movie reviews
      description: Fetch critic or filtered reviews for a Rotten Tomatoes movie.
      operationId: rotten_tomatoes_movie_reviews_v1_rotten_tomatoes_movies__movie_slug__reviews_get
      security:
      - HTTPBearer: []
      parameters:
      - name: movie_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Movie Slug
      - name: cursor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 4096
          - type: 'null'
          title: Cursor
      - name: type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 32
          - type: 'null'
          title: Type
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 50
            minimum: 1
          - type: 'null'
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Movie Reviews V1 Rotten Tomatoes Movies  Movie Slug  Reviews Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/movies/{movie_slug}/cast-and-crew:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes movie cast and crew
      description: Fetch full cast and crew for a Rotten Tomatoes movie.
      operationId: rotten_tomatoes_movie_cast_and_crew_v1_rotten_tomatoes_movies__movie_slug__cast_and_crew_get
      security:
      - HTTPBearer: []
      parameters:
      - name: movie_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Movie Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Movie Cast And Crew V1 Rotten Tomatoes Movies  Movie Slug  Cast And Crew Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/tv/{tv_show_slug}:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes TV show details
      description: Fetch Rotten Tomatoes metadata for a TV series by slug.
      operationId: rotten_tomatoes_tv_show_details_v1_rotten_tomatoes_tv__tv_show_slug__get
      security:
      - HTTPBearer: []
      parameters:
      - name: tv_show_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Tv Show Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Tv Show Details V1 Rotten Tomatoes Tv  Tv Show Slug  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/tv/{tv_show_slug}/seasons/{season_number}:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes TV show season
      description: Fetch metadata for one season of a Rotten Tomatoes TV series.
      operationId: rotten_tomatoes_tv_show_seasons_v1_rotten_tomatoes_tv__tv_show_slug__seasons__season_number__get
      security:
      - HTTPBearer: []
      parameters:
      - name: tv_show_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Tv Show Slug
      - name: season_number
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 2
          title: Season Number
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Tv Show Seasons V1 Rotten Tomatoes Tv  Tv Show Slug  Seasons  Season Number  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/tv/{tv_show_slug}/episodes/{season_number}/{episode_number}:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes TV show episode
      description: Fetch metadata for one episode of a Rotten Tomatoes TV series.
      operationId: rotten_tomatoes_tv_show_episodes_v1_rotten_tomatoes_tv__tv_show_slug__episodes__season_number___episode_number__get
      security:
      - HTTPBearer: []
      parameters:
      - name: tv_show_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Tv Show Slug
      - name: season_number
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 2
          title: Season Number
      - name: episode_number
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 2
          title: Episode Number
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Tv Show Episodes V1 Rotten Tomatoes Tv  Tv Show Slug  Episodes  Season Number   Episode Number  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/tv/{tv_show_slug}/cast-and-crew:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes TV show cast and crew
      description: Fetch full cast and crew for a Rotten Tomatoes TV series.
      operationId: rotten_tomatoes_tv_show_cast_and_crew_v1_rotten_tomatoes_tv__tv_show_slug__cast_and_crew_get
      security:
      - HTTPBearer: []
      parameters:
      - name: tv_show_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Tv Show Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Tv Show Cast And Crew V1 Rotten Tomatoes Tv  Tv Show Slug  Cast And Crew Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/tv/{tv_show_slug}/seasons/{season_number}/reviews:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes TV season reviews
      description: Fetch critic or filtered reviews for a TV season on Rotten Tomatoes.
      operationId: rotten_tomatoes_tv_show_season_reviews_v1_rotten_tomatoes_tv__tv_show_slug__seasons__season_number__reviews_get
      security:
      - HTTPBearer: []
      parameters:
      - name: tv_show_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Tv Show Slug
      - name: season_number
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 2
          title: Season Number
      - name: cursor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 4096
          - type: 'null'
          title: Cursor
      - name: type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 32
          - type: 'null'
          title: Type
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 50
            minimum: 1
          - type: 'null'
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Tv Show Season Reviews V1 Rotten Tomatoes Tv  Tv Show Slug  Seasons  Season Number  Reviews Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rotten-tomatoes/celebrities/{celebrity_slug}:
    get:
      tags:
      - rotten-tomatoes
      summary: Rotten Tomatoes celebrity details
      description: Fetch Rotten Tomatoes profile and filmography for a celebrity.
      operationId: rotten_tomatoes_celebrity_details_v1_rotten_tomatoes_celebrities__celebrity_slug__get
      security:
      - HTTPBearer: []
      parameters:
      - name: celebrity_slug
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Celebrity Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rotten Tomatoes Celebrity Details V1 Rotten Tomatoes Celebrities  Celebrity Slug  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-refined-from:
- vee3-io.json
- vee3-io-openapi.json