{
  "swagger": "2.0",
  "info": {
    "version": "1.0.0",
    "title": "TimesTags API",
    "description": "With the TimesTags API, you can mine the riches of the New York Times tag set. The TimesTags service matches your query to the controlled vocabularies that fuel NYTimes.com metadata. You supply a string of characters, and the service returns a ranked list of suggested terms.",
    "logo": {
      "url": "img/logo_api_tags_150x150.png"
    }
  },
  "host": "api.nytimes.com",
  "schemes": [
    "http",
    "https"
  ],
  "basePath": "/svc/suggest/v1",
  "produces": [
    "application/json"
  ],
  "security": [
    {
      "apikey": [
      ]
    }
  ],
  "paths": {
    "/timestags": {
      "get": {
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "description": "Your search query",
            "type": "string",
            "required": true
          },
          {
            "name": "filter",
            "in": "query",
            "description": "If you do not specify a value for filter (see the Optional Parameters), your query will be matched to tags in all four Times dictionaries: subject, geographic location, organization and person. To use more than one, separate with commas.\n",
            "required": false,
            "type": "string",
            "enum": [
              "Des",
              "Geo",
              "Org",
              "Per"
            ]
          },
          {
            "name": "max",
            "in": "query",
            "description": "Sets the maximum number of results",
            "default": 10,
            "required": false,
            "type": "integer"
          }
        ],
        "responses": {
          "200": {
            "description": "An array of tags",
            "schema": {
              "type": "array",
              "items": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "securityDefinitions": {
    "apikey": {
      "type": "apiKey",
      "name": "api-key",
      "in": "query"
    }
  }
}