Search for Item

{
  "type": "object",
  "properties": {
    "include_external": {
      "type": "string",
      "description": "If `include_external=audio` is specified it signals that the client can play externally hosted audio content, and marks\nthe content as playable in the response. By default externally hosted audio content is marked as unplayable in the response.\n",
      "enum": [
        "audio"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "The maximum number of results to return in each item type.\n"
    },
    "offset": {
      "type": "integer",
      "description": "The index of the first result to return. Use\nwith limit to get the next page of search results.\n"
    },
    "q": {
      "type": "string",
      "description": "Your search query.\n\nYou can narrow down your search using field filters. The available filters are `album`, `artist`, `track`, `year`, `upc`, `tag:hipster`, `tag:new`, `isrc`, and `genre`. Each field filter only applies to certain result types.\n\nThe `artist` and `year` filters can be used while searching albums, artists and tracks. You can filter on a single `year` or a range (e.g. 1955-1960).<br />\nThe `album` filter can be used while searching albums and tracks.<br />\nThe `genre` filter can be used while searching artists and tracks.<br />\nThe `isrc` and `track` filters can be used while searching tracks.<br />\nThe `upc`, `tag:new` and `tag:hipster` filters can only be used while searching albums. The `tag:new` filter will return albums released in the past two weeks and `tag:hipster` can be used to return only albums with the lowest 10% popularity.<br />\n"
    },
    "type": {
      "type": "array",
      "description": "A comma-separated list of item types to search across. Search results include hits\nfrom all the specified item types. For example: `q=abacab&type=album,track` returns\nboth albums and tracks matching \"abacab\".\n",
      "items": {
        "type": "string",
        "enum": [
          "album",
          "artist",
          "playlist",
          "track",
          "show",
          "episode",
          "audiobook"
        ]
      }
    }
  },
  "required": [
    "q",
    "type"
  ],
  "additionalProperties": false
}