YouTube autocomplete API: search suggestions as JSON

export TOOLZERHUB_API_KEY=your_key
curl -H "x-api-key: $TOOLZERHUB_API_KEY" \
  "https://api.toolzerhub.com/v2/youtube/suggestions?search_term=python%20tutorial&region_code=US&language_code=en"

{
  "search_term": "python tutorial",
  "suggestions": [
    "python tutorial",
    "python tutorial for beginners",
    "python tutorial 2025",
    "python tutorial for experienced programmers",
    "python tutorial bro code",
    "python tutorial 2026"
  ]
}

import csv
import os
import string
import sys
import time

import requests

URL = "https://api.toolzerhub.com/v2/youtube/suggestions"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
FIELDS = ["seed", "region", "language", "prefix", "position", "suggestion"]


def suggest(term, region, language, tries=3):
    # Retry rate limits, server errors and dropped connections.
    for attempt in range(tries):
        last = attempt == tries - 1
        try:
            r = requests.get(URL, headers=HEADERS, params={"search_term": term, "region_code": region, "language_code": language}, timeout=120)
        except requests.RequestException:
            if last:
                raise
            time.sleep(5 * (attempt + 1))
            continue
        if r.status_code in (429, 500, 502, 503, 504) and not last:
            time.sleep(5 * (attempt + 1))
            continue
        r.raise_for_status()
        return r.json()["data"]["suggestions"]


def main(seeds, regions="US", language="en", out="youtube_autocomplete.csv"):
    with open(out, "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=FIELDS)
        writer.writeheader()
        for seed in filter(None, (s.strip() for s in seeds.split(","))):
            for region in filter(None, (r.strip().upper() for r in regions.split(","))):
                seen = set()
                # The seed alone, then the seed followed by each letter, the way people type.
                for prefix in [seed] + [f"{seed} {c}" for c in string.ascii_lowercase]:
                    for position, s in enumerate(suggest(prefix, region, language), 1):
                        if s not in seen:
                            seen.add(s)
                            writer.writerow({"seed": seed, "region": region, "language": language, "prefix": prefix,
                                             "position": position, "suggestion": s})
                print(f"{seed} ({region}): {len(seen)} unique suggestions from 27 calls")


if __name__ == "__main__":
    if len(sys.argv) < 2:
        sys.exit('usage: python youtube_autocomplete.py "python tutorial,meal prep" [US,GB] [en] [out.csv]')
    if not HEADERS["x-api-key"]:
        sys.exit("set TOOLZERHUB_API_KEY first")
    main(*sys.argv[1:])