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 per successful request.
About this endpoint
Launch monitors and Shorts trackers often follow a YouTube tag (#productdrop, a challenge name, a branded campaign) rather than a free-text phrase. Google's YouTube Data API search is built around keywords and quotas; hashtag-led feeds are awkward to reproduce with scrapers that break when browse clients rotate.
`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. Full parameters and examples are in the API docs.
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 not invent or parse it.
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.