YouTube Hashtag Search
YouTube hashtag feeds are public video collections associated with a topic tag, with titles, descriptions, channel identity, thumbnails, duration, publication details, and visible engagement. These records support topic mapping, campaign participation review, Shorts sampling, and comparative content analysis.
Features
- Hashtag-feed discoveryFind public videos associated with a hashtag without supplying video or channel URLs.
- All-content and Shorts modesSet content_type to all for the exposed hashtag feed or shorts for a Shorts-only sample.
- Video and channel contextReturn titles, descriptions, channel identity, thumbnails, duration, publication details, and visible view, like, and comment counts.
- Retained source hashtagEach saved record includes the normalized source hashtag retained for that video result.
Parameters
| Parameters | Required | Description |
|---|---|---|
hashtags | Required | One or more non-empty hashtags. A leading # is optional and removed before collection. |
results_limit | Optional | Maximum videos to collect per hashtag, from 20 to 2,000; defaults to 100. |
content_type | Optional | Content mode: all for the exposed hashtag feed or shorts for Shorts-only results; defaults to all. |
How to Use
Choose tags that represent the topic boundaries you want to inspect, then keep the content mode and per-tag limit consistent when samples need to be compared.
- Prepare one or more non-empty hashtags, with or without the leading #, and select all or shorts.
- POST hashtags, results_limit, and content_type to /v1/youtube/hashtag-search.
- Save the returned task_id and poll /v1/tasks/{task_id} until the task succeeds or fails.
- Read normalized videos from data.results.items and continue with next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/youtube/hashtag-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["#technology"],"results_limit":20,"content_type":"shorts"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Campaign participation review: Use hashtag-feed samples, video descriptions, channel identity, and visible engagement to review public campaign participation.
- Shorts topic sampling: Select shorts to build a focused sample of short-form videos associated with a topic tag.
- Topic dataset preparation: Combine video IDs, URLs, publication details, channel context, metrics, and retained source tags into structured research datasets.
Pro Tips
- Normalize your input list before submission so #technology and technology do not trigger duplicate collection work.
- Use one hashtag per task when attribution across overlapping feeds matters, because duplicate video IDs are saved once and retain one source hashtag.
- Treat results_limit as a per-hashtag ceiling; collection can stop earlier when the feed ends or exposes fewer eligible videos.
- Keep all and shorts samples separate when comparing formats so a mixed feed does not distort the short-form subset.
- Store thumbnail and source URLs as references rather than assuming they are permanent media downloads.
Related APIs
Use these APIs when you need a different type of public YouTube data.
- YouTube Channel Videos API — Collect regular public videos from channel URLs, excluding Shorts and live streams.
- YouTube Comments API — Collect public comments, authors, engagement, source videos, and conversation context.
- YouTube Transcripts API — Retrieve available plain-text transcripts with optional language selection.
- YouTube Channels API — Retrieve public channel identity, images, verification, and visible audience statistics.
- YouTube Videos API — Retrieve metadata, thumbnails, duration, and engagement for known video or Short URLs.
- YouTube Shorts API — Collect public Shorts, thumbnails, duration, publication details, and engagement by channel.
- YouTube Search API — Search public regular videos by keyword with supported metadata filters.
- YouTube Channel Live Videos API — Collect public broadcast records exposed on channel live surfaces, with source context and visible metrics.
- YouTube Comment Replies API — Continue a known YouTube comment thread from its reply token and return public replies, authors, engagement, and parent context.
- YouTube Community Posts API — Collect public Community-tab posts from channel URLs, including text, channel identity, timestamps, image references, and source context.
- YouTube Playlist Videos API — Collect video identity, channel context, thumbnails, duration, and playlist provenance from public playlist URLs or IDs.