YouTube hub

YouTube Search Suggestions API

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

GET /v1/youtube/search/suggestions

1 credit Failed requests are free

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

YouTube Search Suggestions API 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.