YouTube Search Ranking, United States (English, Top 20 Blocks by Keyword)

{
  "type": "object",
  "required": [
    "keyword",
    "location_code",
    "language_code",
    "block_depth"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 700,
      "minLength": 1,
      "description": "The search query, as a person would type it into the YouTube search box."
    },
    "block_depth": {
      "enum": [
        20
      ],
      "type": "integer",
      "default": 20,
      "description": "How many result blocks to read; only 20, the default, is offered."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The language of the results; only English is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "Where the search is made from; only 2840 (the United States) is offered."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "A channel entry's name."
                },
                "type": {
                  "type": "string",
                  "description": "The entry type: youtube_video or youtube_channel."
                },
                "title": {
                  "type": "string",
                  "description": "A video's title."
                },
                "video_id": {
                  "type": "string",
                  "description": "A video's YouTube video ID."
                },
                "channel_id": {
                  "type": "string",
                  "description": "The YouTube channel ID of the video's channel, or of a channel entry."
                },
                "rank_group": {
                  "type": "number",
                  "description": "The entry's position among entries of the same type."
                },
                "views_count": {
                  "type": "number",
                  "description": "A video's view count."
                },
                "channel_name": {
                  "type": "string",
                  "description": "The name of a video's channel."
                },
                "rank_absolute": {
                  "type": "number",
                  "description": "The entry's position in the results, counting every entry."
                },
                "publication_date": {
                  "type": "string",
                  "description": "How long ago a video was published, as relative text the page shows (in years or months), not a date."
                },
                "duration_time_seconds": {
                  "type": "number",
                  "description": "A video's length in seconds."
                }
              }
            },
            "description": "The search results, in ranked order."
          },
          "keyword": {
            "type": "string",
            "description": "The keyword searched for."
          },
          "datetime": {
            "type": "string",
            "description": "When the search ran, as 'YYYY-MM-DD hh:mm:ss +00:00' (UTC)."
          },
          "items_count": {
            "type": "number",
            "description": "How many entries came back."
          }
        }
      }
    }
  },
  "description": "The search result: one entry for the one search made."
}