YouTube Hashtag Search API

YouTube Hashtag Search

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

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.

1. Prepare one or more non-empty hashtags, with or without the leading #, and select all or shorts.
2. POST hashtags, results_limit, and content_type to /v1/youtube/hashtag-search.
3. Save the returned task_id and poll /v1/tasks/{task_id} until the task succeeds or fails.
4. 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 true

Best 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