Get suggestions

getSuggestions(query, options?): SuggestionsResponse

GET/v1/search/suggestionsFree

Returns autocomplete strings for a partial query. Use this for search-as-you-type UIs. This endpoint is free.

Security

API Token

The preferred authorization scheme for the YouTube Transcript API. Create a key with transcripts:read in the developer dashboard.

Example: Authorization: Bearer YOUR_API_KEY

See Authentication for scopes and rate limits.

Accepted permissions (at least one required)

transcripts:read

ParametersExpand Collapse

q:string

Query param:

Partial query string.

ReturnsExpand Collapse

query:string

Echoed input.

suggestions:string[]

Ranked completion strings.

Completely free

Search suggestions consume 0 credits.

Get suggestions

const q = encodeURIComponent("nextjs 1");
const response = await fetch(
  `https://api.ytapi.dev/v1/search/suggestions?q=${q}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.YT_API_KEY}`,
    },
  },
);

const data = await response.json();
console.log(data.suggestions);

import os
import requests

response = requests.get(
    "https://api.ytapi.dev/v1/search/suggestions",
    headers={"Authorization": f"Bearer {os.environ['YT_API_KEY']}"},
    params={"q": "nextjs 1"},
)

print(response.json())

curl -X GET "https://api.ytapi.dev/v1/search/suggestions?q=nextjs+1" \
  -H "Authorization: Bearer $YT_API_KEY"

package main

import (
	"fmt"
	"net/http"
	"os"
)

func main() {
	url := "https://api.ytapi.dev/v1/search/suggestions?q=nextjs+1"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("YT_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	fmt.Println(resp.Status)
}

200 example

{
  "query": "nextjs 1",
  "suggestions": [
    "nextjs 15 tutorial",
    "nextjs 15 crash course",
    "nextjs 15 server actions",
    "nextjs 15 auth",
    "nextjs 15 cache components"
  ]
}