Search TikTok videos
Search TikTok videos by keyword.
Operation
/v1/tiktok/searchHeaders
API key (`sfk_...`)
Parameters
Search query text for TikTok videos.
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 region code for localized search results.
min 2 chars · max 2 chars
Opaque pagination cursor returned by a previous response.
min 1 chars
When true, returns a smaller response with fewer fields.
Response fields
Endpoint-specific response payload.
Search query that was evaluated for this response.
Matching TikTok videos. TikTok may return the same video more than once for some searches.
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.
Pagination state for the current response.
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
Responses
Video search results for the requested query.
Error codes