The New York Times Company Movies API

swagger: '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

    ```

    '
host: api.nytimes.com
basePath: /svc/archive/v1
schemes:
- https
produces:
- application/json
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
        type: string
      responses:
        '200':
          description: Array of movie critics.
          schema:
            type: object
            properties:
              status:
                type: string
              copyright:
                type: string
              num_results:
                type: integer
              results:
                type: array
                items:
                  $ref: '#/definitions/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
        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
        default: 0
        type: integer
      - name: order
        in: query
        description: How to order the results.
        required: false
        type: string
        enum:
        - by-opening-date
        - by-publication-date
        - by-title
      responses:
        '200':
          description: Array of movie reviews.
          schema:
            type: object
            properties:
              status:
                type: string
              copyright:
                type: string
              has_more:
                type: boolean
              num_results:
                type: integer
              results:
                type: array
                items:
                  $ref: '#/definitions/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.
          schema:
            type: object
            properties:
              status:
                type: string
              copyright:
                type: string
              has_more:
                type: boolean
              num_results:
                type: integer
              results:
                type: array
                items:
                  $ref: '#/definitions/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.
definitions:
  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: '#/definitions/Link'
      multimedia:
        $ref: '#/definitions/MultiMedia'
  Link:
    type: object
    properties:
      type:
        type: string
      url:
        type: string
      suggested_link_text:
        type: string
  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
  MultiMedia:
    type: object
    properties:
      type:
        type: string
      src:
        type: string
      width:
        type: integer
      height:
        type: integer
securityDefinitions:
  apikey:
    type: apiKey
    name: api-key
    in: query