YouTube Search Suggestions API
The autocomplete YouTube shows while someone types, for keyword research and search tools.
GET /v1/youtube/search/suggestions1 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.
Example response
A 200 response. Live responses have the same shape with current data.
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.
Other YouTube endpoints
- ChannelGET /v1/youtube/channel
- Channel videosGET /v1/youtube/channels/videos
- Channel shortsGET /v1/youtube/channels/shorts
- Channel searchGET /v1/youtube/channels/search
- Channel community postsGET /v1/youtube/channels/community-posts
- Channel playlistsGET /v1/youtube/channels/playlists
- Channel live streamsGET /v1/youtube/channels/live-streams
- PlaylistGET /v1/youtube/playlists