| name | hashtag-research |
| description | Research a hashtag or keyword — volume/popularity signals, top and recent content, and related hashtags — on TikTok, Douyin, Instagram, Xiaohongshu, and more. Use when the user asks "research |
Hashtag Research
Assess a hashtag/keyword and surface its top content and related tags.
Setup gate
[ -z "${TIKHUB_API_KEY:-}" ] && echo "Set TIKHUB_API_KEY first (see tikhub-onboarding)."
Workflow
- Pick platform(s) and the hashtag/keyword.
- Pull signals + content:
- TikTok:
ads/get_trends_hashtag_detail (hashtag_id) and ads/get_trends_hashtag_list;
pull videos under a hashtag with app/v3/fetch_hashtag_video_list (ch_id).
- Douyin:
search/fetch_general_search_v2 (POST) for hashtag/keyword content.
- Instagram:
v2/search_hashtags + v2/fetch_hashtag_posts.
- Xiaohongshu:
app_v2/search_notes (keyword).
- Discover exact paths:
tikhub-find-endpoint "hashtag" --platform <slug>.
- Summarize: estimated popularity/volume, top posts (engagement), recent momentum, and a list
of related/co-occurring hashtags pulled from the top posts.
- Recommend a tag set for the user's niche.
Cost awareness
Detail/list calls are 1 each; pulling top-posts pages multiplies calls. Cap and warn for deep pulls.
Verification gate
- Hashtag resolved (or clearly report "no data / low volume").
- Top posts are actually tagged with the hashtag.
- Related tags derived from real co-occurrence, not guessed.
Red flags
- Inventing volume numbers — only report what the API returns; otherwise say "not available".
- Recommending banned/irrelevant tags.
