Search TikTok by hashtag
Search TikTok videos by hashtag.
Use `data.page.hasMore` and `data.page.nextCursor` for pagination. Repeat the same hashtag and filters when requesting the next page.
Headers
Get your API keyAPI key (`sfk_...`)
Hashtag to search for. A leading # is optional.
min 1 chars · max 256 chars
Optional region (country code) for the request. This sets the proxy region and does not filter results to that country only.
min 1 chars
Pagination cursor returned by a previous response.
min 1 chars
Whether to request a smaller response with fewer fields.
Endpoint-specific response payload.
Hashtag evaluated for this response, without a leading #.
Region applied for this response when one was requested.
TikTok videos matching the hashtag in order. Duplicate video ids may appear when the platform returns them.
TikTok video identifier.
min 1 chars
Caption text shown for the TikTok video.
ISO-8601 timestamp when the video was created, when available.
Canonical public TikTok URL for the video.
Best available thumbnail or cover image URL for the video.
Video duration in milliseconds, when available.
≥ 0
Whether the video is pinned on the profile.
Whether TikTok marks the video as an ad.
Engagement metrics for the video.
View count reported by TikTok for the video.
≥ 0
Like count reported by TikTok for the video.
≥ 0
Comment count reported by TikTok for the video.
≥ 0
Share count reported by TikTok for the video.
≥ 0
Save or collection count reported by TikTok for the video.
≥ 0
Download-related media URLs for the video.
Best available downloadable video URL, usually with watermark.
Best available downloadable video URL without watermark.
Additional TikTok-native fields for this video (for example author, music, challenges, and full `video` and `statistics` objects). Keys that only duplicate the top-level fields are omitted.
Author metadata for this hashtag search result.
TikTok user id for the video author when available.
TikTok handle for the video author when available.
Display name for the video author when available.
Avatar image URL for the video author when available.
Whether the author is verified on TikTok.
Number of video rows returned in this response.
≥ 0
Pagination information for the current hashtag search page.
Cursor to pass in the next request when more videos are available.
Whether another page of videos is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/tiktok/search/hashtags?hashtag=trending" \
-H "x-api-key: YOUR_API_KEY"Responses
Hashtag search results for the requested tag.