Search TikTok Top results
Search TikTok Top results by keyword (not videos-only — use tiktok.search.videos.list for that).
Headers
Get your API keyAPI key (`sfk_...`)
Search query text for TikTok Top results.
min 1 chars · max 512 chars
Optional upload date filter for video results.
one of: yesterday, this-week, this-month, last-3-months, last-6-months, all-time
Optional sort order for search results.
one of: relevance, most-liked, date-posted
Optional two-letter ISO 3166-1 country code for localized search results.
Opaque pagination cursor returned by a previous response.
min 1 chars
Endpoint-specific response payload.
Search query that was evaluated for this response.
Matching TikTok posts (videos and photo slideshows).
TikTok post identifier.
min 1 chars
Caption text shown for the post.
When the post was created (ISO-8601).
Canonical public TikTok URL for the post.
Thumbnail or cover image URL when available.
Duration in milliseconds when available.
≥ 0
Whether the post is a video or a photo slideshow.
one of: video, slideshow
Whether TikTok marks the post as pinned in this result set.
Whether TikTok marks the post as an ad.
Engagement metrics for the post.
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
Media URLs for the post.
Downloadable video URL when available.
Download URL without watermark when available.
Ordered image URLs for photo slideshow posts. Empty for videos.
Author metadata for this Top search result.
TikTok user id for the author when available.
TikTok handle for the author when available.
Display name for the author when available.
Avatar image URL for the author when available.
Whether the author is verified on TikTok.
Additional TikTok-native fields for this post.
Pagination state for the current Top search page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/tiktok/search/top?query=funny" \
-H "x-api-key: YOUR_API_KEY"Responses
Top search results for the requested query.