YouTube Hashtag Search API
Tagged campaign discovery for public YouTube videos and Shorts — hashtag in, structured rows out, same envelope as the rest of the YouTube tag.
GET /v1/youtube/search/hashtags1 credit Failed requests are free
About this endpoint
GET /v1/youtube/search/hashtags takes a required hashtag query param (leading # is optional) and returns matching public videos and Shorts in the shared Social Fetch envelope. Optional type is all (default) or shorts. Each row can include id, kind (video or short), url, title, description, thumbnail, channel, view counts, publish time, duration, and badges when YouTube exposes them. When data.page.hasMore is true, pass data.page.nextCursor as cursor on the next call. Branch on data.lookupStatus before you write rows, and bill from meta.creditsCharged.
This route is tag-led discovery. Free-text keyword search is GET /v1/youtube/search. For a known channel's uploads use the channel videos or shorts list routes. All of them share one Social Fetch API key.
YouTube Hashtag Search API FAQ
What does the YouTube Hashtag Search API return?
A page of public YouTube videos and Shorts for the requested tag, plus the normalized hashtag (without #), the applied type filter, totalResults for this page, and pagination under data.page (hasMore, nextCursor). Each response uses the shared Social Fetch envelope with data.lookupStatus, meta.requestId, and meta.creditsCharged.
How do I call YouTube hashtag search?
Send GET /v1/youtube/search/hashtags with x-api-key and a required hashtag parameter. A leading # is optional. Optionally add type (all or shorts) and cursor. See the API docs for parameters and examples.
How much does YouTube hashtag search 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. Each paginated page is a separate billed request.
Is this the same as YouTube keyword search?
No. GET /v1/youtube/search/hashtags is hashtag-only discovery. Free-text keyword search is GET /v1/youtube/search. Use hashtag search when the campaign is tag-led; use keyword search when you have a phrase.
Can I limit results to Shorts only?
Yes. Pass type=shorts. Omit type or pass type=all for videos and Shorts together. Keep the same type when paginating with cursor.
How does pagination work on YouTube hashtag search?
When data.page.hasMore is true, pass data.page.nextCursor as the cursor query param on the next request. Keep the same hashtag and type across pages. Do not infer end-of-results from result counts alone. The cursor is opaque.
Do I need a Google Cloud project to search YouTube by hashtag?
No. You authenticate to Social Fetch with an API key. The route reads public hashtag results; it does not act on behalf of a logged-in YouTube user or consume your YouTube Data API quota.