Search APIs
Loading…
← API Store
Social

YouTube

YouTube

YouTube search suggestions

GET /youtube/v1/search/typeahead
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: how to

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "credits_used": 1,
  "query": "how to",
  "suggestions": [
    "how to tie a tie",
    "how to draw",
    "… 12 more"
  ],
  "suggestions_detail": [
    {
      "extra": [
        [
          512,
          433
        ]
      ],
      "text": "how to tie a tie",
      "type": 0
    },
    {
      "extra": [
        [
          512,
          433
        ]
      ],
      "text": "how to draw",
      "type": 0
    },
    "… 12 more"
  ]
}
Response fields (13)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.credits_usedinteger
$.querystring
$.suggestionsarray
$.suggestions[]string
$.suggestions_detailarray
$.suggestions_detail[]object | string
$.suggestions_detail[].extraarray
$.suggestions_detail[].extra[]array
$.suggestions_detail[].extra[][]integer
$.suggestions_detail[].textstring
$.suggestions_detail[].typeinteger