The New York Times Company Movies API

openapi: 3.2.0
info:
  version: 2.0.0
  title: Archive Movies API
  description: 'The Archive API returns an array of NYT articles for a given month, going back to 1851.  Its response fields are the same as the Article Search API. The Archive API is very useful if you want to build your own database of NYT article metadata. You simply pass the API the year and month and it returns a JSON object with all articles for that month.  The response size can be large (~20mb).


    ```

    /{year}/{month}.json

    ```


    ## Example Call

    ```

    https://api.nytimes.com/svc/archive/v1/2019/1.json?api-key=yourkey

    ```

    '
servers:
- url: https://api.nytimes.com/svc/archive/v1
security:
- apikey: []
tags:
- name: Movies
paths:
  /critics/{reviewer}.json:
    get:
      summary: Get movie critics name, bio and image.
      description: 'Get movie critics. You can either specify the reviewer name or use "all", "full-time", or "part-time".

        '
      tags:
      - Movies
      parameters:
      - name: reviewer
        in: path
        description: Reviewer name or "all" for all reviewers, "full-time" for full-time reviewers, or "part-time" for part-time reviewers.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Array of movie critics.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  copyright:
                    type: string
                  num_results:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Critic'
        '401':
          description: Unauthorized request.  Make sure api-key is set.
        '429':
          description: Too many requests.  You reached your per minute or per day rate limit.
  /reviews/{type}.json:
    get:
      summary: Get movie reviews.
      description: 'Get movie reviews.  Can filter to only return Critics'' Picks.

        Supports ordering results by-title, by-publication-date, or by-opening-date.

        Use offset to paginate thru results, 20 at a time.

        '
      tags:
      - Movies
      parameters:
      - name: type
        description: Filter by critics' pick or not.
        in: path
        required: true
        schema:
          type: string
          enum:
          - all
          - picks
      - name: offset
        in: query
        description: Sets the starting point of the result set.  Needs to be multiple of 20.
        required: false
        schema:
          type: integer
          default: 0
      - name: order
        in: query
        description: How to order the results.
        required: false
        schema:
          type: string
          enum:
          - by-opening-date
          - by-publication-date
          - by-title
      responses:
        '200':
          description: Array of movie reviews.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  copyright:
                    type: string
                  has_more:
                    type: boolean
                  num_results:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Review'
        '401':
          description: Unauthorized request.  Make sure api-key is set.
        '429':
          description: Too many requests.  You reached your per minute or per day rate limit.
  /reviews/search.json:
    get:
      summary: Search for movie reviews.
      description: 'Search for movie reviews.  Supports filtering by Critics'' Pick.

        '
      tags:
      - Movies
      responses:
        '200':
          description: Array of movie reviews.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  copyright:
                    type: string
                  has_more:
                    type: boolean
                  num_results:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Review'
        '401':
          description: Unauthorized request.  Make sure api-key is set.
        '429':
          description: Too many requests.  You reached your per minute or per day rate limit.
components:
  schemas:
    Link:
      type: object
      properties:
        type:
          type: string
        url:
          type: string
        suggested_link_text:
          type: string
    MultiMedia:
      type: object
      properties:
        type:
          type: string
        src:
          type: string
        width:
          type: integer
        height:
          type: integer
    Critic:
      type: object
      properties:
        display_name:
          type: string
        sort_name:
          type: string
        status:
          type: string
        bio:
          type: string
        seo-nmae:
          type: string
        multimedia:
          type: object
          properties:
            resource:
              type: object
              properties:
                type:
                  type: string
                src:
                  type: string
                height:
                  type: integer
                width:
                  type: integer
                credit:
                  type: string
    Review:
      type: object
      properties:
        display_title:
          type: string
        mpaa_rating:
          type: string
        critics_pick:
          type: integer
        byline:
          type: string
        headline:
          type: string
        summary_short:
          type: string
        publication_date:
          type: string
        opening_date:
          type: string
        date_updated:
          type: string
        link:
          $ref: '#/components/schemas/Link'
        multimedia:
          $ref: '#/components/schemas/MultiMedia'
  securitySchemes:
    apikey:
      type: apiKey
      name: api-key
      in: query