Rotten Tomatoes

Rotten Tomatoes Movie Lists API

The Movie Lists API from Rotten Tomatoes — 4 operation(s) for movie lists.

GitHub OpenAPI

Documentation

📖
Documentation
https://developer.fandango.com/rotten_tomatoes
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/rottentomatoes/refs/heads/main/rate-limits/rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/rottentomatoes/refs/heads/main/openapi/rottentomatoes-movie-lists-api-openapi.yml

Other Resources

🔗
TermsOfService
https://developer.fandango.com/Fandango_Terms_of_Service
🔗
TermsOfService
https://www.rottentomatoes.com/policies/terms-of-use
🔗
PrivacyPolicy
https://www.versantprivacy.com/privacy
🔗
PostmanWorkspace
https://www.postman.com/api-evangelist/rotten-tomatoes/overview
🔗
BusinessProposalForm
https://fandango.az1.qualtrics.com/jfe/form/SV_0ieuKEYpn4S7nnM
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/rottentomatoes/refs/heads/main/plans/plans.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/rottentomatoes/refs/heads/main/finops/finops.yml

OpenAPI Specification

rottentomatoes-movie-lists-api-openapi.yml Raw ↑ 
openapi: 3.0.0
info:
  contact:
    email: mike.ralphson@gmail.com
    name: Mike Ralphson
    url: https://github.com/mermade/mashery2openapi
  description: Test our API services using I/O Docs.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  title: Rotten Tomatoes Detailed Info Movie Lists API
  version: '1.0'
  x-mashery-id: '1217'
  x-jentic-source-url: https://raw.githubusercontent.com/Mermade/openapi_specifications/master/mashery/api.rottentomatoes.com/Rotten-Tomatoes/1.0/swagger.json
servers:
- url: http://api.rottentomatoes.com/api/public/v1.0
security:
- key: []
tags:
- name: Movie Lists
paths:
  /lists/movies/box_office.json:
    get:
      parameters:
      - description: Limits the number of movies returned
        in: query
        name: limit
        required: false
        schema:
          default: '16'
          type: string
      - description: Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.
        in: query
        name: country
        required: false
        schema:
          default: us
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '403':
          description: Forbidden
      tags:
      - Movie Lists
      operationId: BoxOfficeMovieLists
      summary: ''
  /lists/movies/in_theaters.json:
    get:
      parameters:
      - description: The amount of movies in theaters to show per page
        in: query
        name: page_limit
        required: false
        schema:
          default: '16'
          type: string
      - description: The selected page of in theaters movies
        in: query
        name: page
        required: false
        schema:
          default: '1'
          type: string
      - description: Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.
        in: query
        name: country
        required: false
        schema:
          default: us
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '403':
          description: Forbidden
      tags:
      - Movie Lists
      operationId: InTheatersMovieLists
      summary: ''
  /lists/movies/opening.json:
    get:
      parameters:
      - description: Limits the number of opening movies returned
        in: query
        name: limit
        required: false
        schema:
          default: '16'
          type: string
      - description: Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.
        in: query
        name: country
        required: false
        schema:
          default: us
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '403':
          description: Forbidden
      tags:
      - Movie Lists
      operationId: OpeningMoviesMovieLists
      summary: ''
  /lists/movies/upcoming.json:
    get:
      parameters:
      - description: The amount of upcoming movies to show per page
        in: query
        name: page_limit
        required: false
        schema:
          default: '16'
          type: string
      - description: The selected page of upcoming movies
        in: query
        name: page
        required: false
        schema:
          default: '1'
          type: string
      - description: Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.
        in: query
        name: country
        required: false
        schema:
          default: us
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '403':
          description: Forbidden
      tags:
      - Movie Lists
      operationId: UpcomingMoviesMovieLists
      summary: ''
components:
  securitySchemes:
    key:
      in: query
      name: apikey
      type: apiKey
externalDocs:
  description: You can also view our written documentation.
  url: http://developer.rottentomatoes.com/io-docs/docs