Search TikTok videos

Search TikTok videos by free-text keyword (not hashtag — use tiktok.search.hashtag.list for that).

GET/v1/tiktok/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
6
querystringrequiredquery

Search query text for TikTok videos.

min 1 chars · max 512 chars

datePostedstringoptionalquery

Optional upload date filter for video results.

one of: yesterday, this-week, this-month, last-3-months, last-6-months, all-time

sortBystringoptionalquery

Optional sort order for search results.

one of: relevance, most-liked, date-posted

regionstringoptionalquery

Optional two-letter ISO 3166-1 country code for localized search results.

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

trimbooleanoptionalquery

When true, returns a smaller response with fewer fields.

Response fields
30

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Matching TikTok videos. TikTok may return the same video more than once for some searches.

datavideos[]id
string

TikTok video identifier.

min 1 chars

datavideos[]caption
stringnullable

Caption text shown for the TikTok video.

datavideos[]createdAt
stringnullable

ISO-8601 timestamp when the video was created, when available.

datavideos[]url
stringnullable

Canonical public TikTok URL for the video.

datavideos[]thumbnailUrl
stringnullable

Source-platform CDN thumbnail or cover URL when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

datavideos[]durationMs
integernullable

Video duration in milliseconds, when available.

≥ 0

datavideos[]pinned
boolean

Whether the video is pinned on the profile.

datavideos[]isAd
boolean

Whether TikTok marks the video as an ad.

Engagement metrics for the video.

datavideos[]statsviews
integer

View count reported by TikTok for the video.

≥ 0

datavideos[]statslikes
integer

Like count reported by TikTok for the video.

≥ 0

datavideos[]statscomments
integer

Comment count reported by TikTok for the video.

≥ 0

datavideos[]statsshares
integer

Share count reported by TikTok for the video.

≥ 0

datavideos[]statssaves
integer

Save or collection count reported by TikTok for the video.

≥ 0

Download-related media URLs for the video.

datavideos[]mediadownloadUrl
stringnullable

Source-platform CDN download URL, usually with watermark, when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

datavideos[]mediadownloadWithoutWatermarkUrl
stringnullable

Source-platform CDN download URL without watermark when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. Preferred over the watermarked URL when both are present.

datavideos[]details
objectoptional

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.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more videos are available.

datapagehasMore
boolean

Whether another page of videos is available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/tiktok/search?query=web%20scraping" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Video search results for the requested query.