Get YouTube search suggestions
Get YouTube search suggestions for a partial query.
Headers
Get your API keyAPI key (`sfk_...`)
The text typed so far, whole or partial, such as `mr beast`.
min 1 chars · max 512 chars
Endpoint-specific response payload.
Search query that was evaluated for this response.
Suggestions in the order YouTube shows them. Empty when YouTube has none.
Suggested search text.
min 1 chars
`query` for a search phrase, `channel` when YouTube suggests a channel.
one of: query, channel
The suggested channel; null unless `type` is `channel`.
Social platform for this channel.
one of: youtube
YouTube channel id when available.
YouTube channel handle without the leading @, when available.
Public display name of the channel when available.
Channel avatar image URL when available.
Number of suggestions returned in this response.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/youtube/search/suggestions?query=mr%20beast" \
-H "x-api-key: YOUR_API_KEY"Responses
Search suggestions for the requested query.