Search

Search TikTok for videos on a word or a hashtag

What TikTok lists for a word or a hashtag: caption, author, exact views, likes, comments and shares, the date, the length and the tags, read through a paid reader. A word searches TikTok's search bar and takes a window (recency), an order (sort) and a country. A #tag reads that tag's own page, which lists its popular videos of any age in TikTok's order, from any country, and takes none of those. A word's page lists up to 30 videos and a tag's about 20: pass nextCursor back as cursor for the next one, which is another read. The author's follower count is on keyword results and absent from a hashtag feed. A deployment with no TikTok reader configured answers 503 before it charges. Cached for thirty minutes.

get/search/tiktok

Request

  • Base URL: https://api.socially.run/v1
  • URL: https://api.socially.run/v1/search/tiktok
  • Auth: HTTP bearer

Query parameters

qstring required

A word or a phrase for TikTok's search bar ("padaria artesanal"), or a hashtag with its # ("#padaria").

limitinteger

Videos to return, 1–30. One page is one read: a smaller limit on the same question is served from it, and a limit that cuts the page ends the cursor.

recency'day' | 'week' | 'month' | 'quarter' | 'half_year'

Words only. Only videos posted within the window: day, week, month, quarter (90 days) or half_year (180 days), TikTok's own filters. Absent means all time. A hashtag takes none.

sort'relevance' | 'likes' | 'recent'

Words only. relevance (the default) is TikTok's ranking, likes puts the most-liked first and recent the newest. Combine likes with recency to find what is working lately. A hashtag takes none.

countrystring

Words only. Search as a person in this country would, ISO 3166-1 alpha-2 (BR, US, ES). Absent means no country. A code with no region behind it is not refused and filters nothing, so check videos[].region against the country you meant. A hashtag takes none.

cursorstring

The nextCursor of the page before. Each page is another read and another charge, and a cursor only works against the source that made it.

refreshboolean

Read the page again instead of serving the half-hour cache. Charged like any read, and the fresh answer replaces the cached one.

Response

Search TikTok for videos on a word or a hashtag

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.