TikTok Hashtags
TikTok Hashtags are topic labels that connect public videos around a shared phrase, campaign, event, or interest, with creator, content, media, sound, and engagement signals. These records support trend discovery, topic monitoring, campaign research, and audience analysis.
Features
- Parallel hashtag collectionSubmit multiple campaign, brand, or community hashtags in parallel.
- Normalized hashtag inputsNormalize #campaign and campaign into a consistent tag format.
- Per-tag result limitsApply results_limit per tag for clear sample planning.
- Matched hashtag contextPreserve the submitted group through matched_hashtag on every video.
- Comparable video recordsCompare hashtag views, creators, creative elements, and video engagement in one data shape.
Parameters
| Parameters | Required | Description |
|---|---|---|
hashtags | Required | Required list of explicit hashtag values with an optional leading #. |
results_limit | Optional | Positive requested video limit per hashtag. Defaults to 100. |
How to Use
List the tags to track, set a video sample size for each, and build a dataset ready for group comparison.
- Gather campaign, brand, or community tags, normalize space and #space, then deduplicate them.
- POST hashtags and results_limit to /v1/tiktok/hashtags and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or fails.
- Read data.results.items. When has_more is true, continue with next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["space","#astronomy"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- UGC campaign tracking: Collect participation under official campaign tags and examine creator reach, content direction, and engagement distribution.
- Brand-tag asset inventories: Turn brand and product hashtag videos into a searchable library for marketing and social teams.
- Interest-community profiles: Use creators, captions, music, and engagement to understand the content culture around an interest tag.
- Hashtag cohort comparison: Collect several tags in parallel and compare creator mix, creative elements, and performance across groups.
Pro Tips
- Trim the leading #, normalize case, and deduplicate values so every tag has a clear sample group.
- Use the tag count multiplied by results_limit as the requested maximum, not as a guaranteed result total.
- Retain matched_hashtag so videos collected through several groups keep complete provenance.
- Use the same results_limit and collection timing when comparing hashtag cohorts.
- Treat the hashtag view count and each video's engagement metrics as separate point-in-time values.
- Enrich frequent creators with Profiles data to understand the creator mix each tag attracts.
Related APIs
Use these APIs when you need a different type of public TikTok data.
- TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
- TikTok Comments API — Collect public top-level comments, authors, engagement, mentions, and creator interaction flags.
- TikTok Videos API — Retrieve creator, caption, media, music, tags, mentions, and engagement from video URLs.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Comment Replies API — Collect public replies for a known comment using its TikTok video URL and comment ID, with authors, engagement, timestamps, and parent context.
- TikTok Followers List API — Collect normalized profiles visible in public follower lists, with retained source context and supported metrics.
- TikTok Following List API — Collect public profiles followed by TikTok accounts with normalized identity, biographies, visible metrics, and source-account context.
- TikTok User Videos API — Collect public profile-feed videos by username with captions, creators, media, timestamps, engagement, and source-account context.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Trending Feed API — Collect the current public video feed for a region with creator, caption, cover, timestamp, and visible engagement fields.
- TikTok Video Transcript API — Extract available transcript text, language, format, and source context from public video URLs.