> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/youtube/search-suggestions>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/youtube/search-suggestions.mdx>

---

# YouTube Search Suggestions API

The autocomplete YouTube shows while someone types, for keyword research and search tools.

`GET /v1/youtube/search/suggestions` takes a partial `query` and returns `data.suggestions` in the order YouTube shows them. Each suggestion has its `text` and a `type`: `query` for a search phrase, or `channel` when YouTube suggests a channel, with the channel's id, handle, name and avatar in `channel`.

An empty list is a valid answer for a query YouTube has nothing to suggest for. For the search results themselves, use `GET /v1/youtube/search`.

## Request

- **Endpoint:** `GET /v1/youtube/search/suggestions`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/youtube/search/suggestions/get)
- **Platform page:** [/platforms/youtube](https://www.socialfetch.dev/platforms/youtube)

## FAQ

### How do I get YouTube search suggestions via API?

Call GET /v1/youtube/search/suggestions with your Social Fetch API key (x-api-key) and a query. Read data.suggestions.

### How much does the YouTube Search Suggestions API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### What is a channel suggestion?

When the text matches a channel, YouTube suggests the channel itself. Its type is channel, and channel carries the channel's id, handle, name and avatar.
