TikTok Search Scraper: Videos by Keyword, Sort and Date avatar

TikTok Search Scraper: Videos by Keyword, Sort and Date

Pricing

from $0.18 / 1,000 videos

Go to Apify Store
TikTok Search Scraper: Videos by Keyword, Sort and Date

TikTok Search Scraper: Videos by Keyword, Sort and Date

Get the TikTok videos listed for a keyword as one row each: plays, likes, comments, shares, saves, creator followers, music, hashtags and links. Most liked and latest sort, date filters, search suggestions. No login, no browser.

Pricing

from $0.18 / 1,000 videos

Rating

0.0

(0)

Developer

The Mine Works

The Mine Works

Maintained by Community

Actor stats

0

Bookmarked

23

Total users

11

Monthly active users

8 days ago

Last modified

Features

Limited permissions

Share

30 TikTok videos for one keyword with plays, likes, creator followers and music, 25 seconds

From The Mine Works, makers of Amazon Product Scraper and B2B Leads Finder, with over 330,000 runs across 320+ public actors.

Updated 10 Nov 2026: rebuilt. TikTok closed its keyword search to visitors who are not logged in in late October 2026, so this actor now reads the videos TikTok lists on its public topic pages for your keyword, and for the phrases TikTok itself suggests for it. No browser, much cheaper per row. Bookmark this Actor on its Store page so it is one click away next time.

Why choose this actor?

  • Real, on topic rows. In our test, 12 of 12 ordinary keywords returned data, and 8 of them reached the 300 rows we asked for. Every post from a suggested phrase must mention every word of your keyword, or it is dropped and not charged. Posts on TikTok's own page for your phrase are kept as TikTok lists them.
  • Deeper than one page. One TikTok topic page lists about 90 posts. With deep search on (the default) a popular keyword also reads the topic pages of the phrases TikTok suggests for it, and reached 514 rows for "lab grown diamond" and 713 for "skincare routine" in our test.
  • The creator next to the post. Every row has plays, likes, comments, shares and saves, and the creator's followers, total likes, post count and verified badge, plus the sound, hashtags, cover and links. TikTok's search suggestions come from the same actor. No TikTok account, cookies, proxy or API key.

Run it on Apify

Part of The Mine Works Social media and video family: Threads Scraper, Reddit Scraper, Threads Search Scraper, Instagram Profile Scraper, Instagram Followers & Following, Reddit Search Scraper.

Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 30 TikTok videos for "skincare routine", posted as recently as the day before. It took 25 to 39 seconds in our test runs, most of it container start:

{
"searchQueries": ["skincare routine"],
"maxItems": 30
}

Put several keywords on separate lines to look them all up in one run. A video that two keywords find is delivered once.

Apify's free plan includes $5 of credit every month, which pays for thousands of rows at this actor's price.

Copy to your AI assistant

themineworks/tiktok-search-scraper on Apify. Returns the TikTok videos listed for a keyword as flat rows, with no login. Call ApifyClient("TOKEN").actor("themineworks/tiktok-search-scraper").call(run_input={"searchQueries": ["skincare routine"], "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give searchQueries (list of keywords, up to 100; a tiktok.com/search link also works). Optional: maxItems (default 50, 1 to 1000, per keyword), sortBy (relevance, most_liked, latest), datePosted (any, last_24_hours, last_week, last_month, last_3_months, last_6_months), contentType (videos, suggestions), deepSearch (default true), uniqueAuthors, minPlays, minLikes, includeSuggestions, suggestionDepth (1 or 2). Video rows have result_type video and carry video_id, video_url, description, created_utc, created_at, duration_sec, play_count, like_count, comment_count, share_count, save_count, hashtags, author_username, author_nickname, author_id, author_sec_uid, author_url, author_avatar_url, author_verified, author_followers, author_following, author_total_likes, author_video_count, music_id, music_title, music_author, music_is_original, cover_url, video_play_url, video_download_url, video_width, video_height, subtitle_languages, subtitle_url, is_ad, is_sponsored, keyword, search_rank, search_page, search_pass, scraped_at. Suggestion rows have result_type suggestion with keyword, suggestion, suggestion_type, suggestion_rank, suggestion_depth, suggestion_group_id, parent_suggestion. Each run also writes one row with _type "summary" and one with _type "info" when rows were delivered; neither is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~tiktok-search-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral

Key features

  • Most liked, latest or relevance. sortBy ranks everything found for the keyword. Combine it with datePosted (last 24 hours, week, month, 3 months, 6 months) for "the best posts about this topic this week" or "everything new about my brand since yesterday". TikTok's topic pages have no sort or date filter of their own, so the actor reads the pages first and then sorts and filters. A date window or a minimum on likes makes a run read more pages to find enough rows.
  • Deep search. With deepSearch on and a maxItems above what one topic page holds, the actor reads the topic pages of the phrases TikTok suggests for your keyword ("lab grown diamond rings", "lab grown diamonds vs real"). Only posts that mention every word of your keyword are kept. Posts are never delivered or charged twice.
  • Creator columns on every row. author_followers, author_total_likes, author_video_count, author_verified, author_sec_uid and the profile link. Turn on uniqueAuthors to keep one post per creator and you have a creator list for the topic (1,902 different creators in one 10 keyword test).
  • Search suggestions. TikTok's autocomplete suggestions and related questions for each keyword, with suggestionDepth 2 to also expand the first 10 suggestions. Plain requests, fast.
  • Engagement filters. minPlays and minLikes drop weak posts before they are delivered, so you are not charged for them.
  • Stops cleanly. Six refused requests in a row end the run, a keyword with no topic page costs one request, and the run stops before its time limit and keeps every row. The summary row says why each keyword stopped.

How to use it

The best posts about a topic this month

{
"searchQueries": ["lab grown diamond"],
"sortBy": "most_liked",
"datePosted": "last_month",
"maxItems": 50
}

The most liked posts of the last 30 days come first, each with like_count, play_count and the creator's author_followers. Divide play_count by author_followers in a spreadsheet to find posts that beat their creator's usual reach.

Watch a brand or a product keyword every day

{
"searchQueries": ["your brand name", "your product name"],
"sortBy": "latest",
"datePosted": "last_week",
"maxItems": 100,
"deepSearch": false
}

Save it as a task and add a daily schedule. Compare video_id with the previous run to see only the new posts. A brand name works when TikTok has a topic page for it; a keyword with no topic page returns an info row and costs nothing.

A creator shortlist for a niche

{
"searchQueries": ["sourdough baking", "bread recipe"],
"maxItems": 300,
"uniqueAuthors": true,
"minLikes": 500
}

One post per creator, each with author_followers, author_total_likes and author_url. Sort by author_followers and you have outreach candidates.

Keyword research from TikTok's own suggestions

{
"searchQueries": ["lab grown diamond"],
"contentType": "suggestions",
"suggestionDepth": 2
}

About 56 suggestions for the keyword at depth 2 in our test, each with its type, rank and the suggestion it was found under.

Videos and suggestions in one run

Set includeSuggestions to true next to any of the inputs above. Suggestion rows have result_type suggestion; filter on result_type to separate them.

Input parameters

ParameterTypeDefaultWhat it does
searchQueriesarray of strings["skincare routine"]Keywords, one lookup each. A tiktok.com/search link also works. Up to 100.
contentTypestringvideosvideos or suggestions (suggestions only).
maxItemsinteger50Most posts per keyword, 1 to 1,000. A popular keyword has about 500 to 700 on topic posts in all.
sortBystringrelevancerelevance (TikTok's order), most_liked or latest.
datePostedstringanyany, last_24_hours, last_week, last_month, last_3_months or last_6_months.
deepSearchbooleantrueAlso read the topic pages of the phrases TikTok suggests for the keyword when one page ends before maxItems.
uniqueAuthorsbooleanfalseKeep only the first post of each creator across the run.
minPlaysintegeremptySkip posts with fewer plays. Skipped posts are not charged.
minLikesintegeremptySkip posts with fewer likes. Skipped posts are not charged.
includeSuggestionsbooleanfalseAdd suggestion rows for each keyword next to the posts.
suggestionDepthinteger11 or 2. At 2 the first 10 autocomplete suggestions are expanded too.

What data do you get?

One row per post or suggestion. Rows have no _type field; the summary, info and error rows do, so a filter on _type separates them. Fields TikTok does not show for a post are left out of that row.

FieldWhat it is
result_typevideo or suggestion
video_id, video_urlTikTok post id and its permanent link
descriptionCaption
created_utc, created_atPosted time, Unix seconds and ISO 8601 UTC
duration_secVideo length
play_count, like_count, comment_count, share_count, save_countEngagement counts, exact figures
hashtags, mentionsHashtags and mentioned usernames from the caption, without the symbols
author_username, author_nickname, author_id, author_sec_uid, author_url, author_avatar_urlThe creator and the profile link
author_verified, author_followers, author_following, author_total_likes, author_video_countCreator badge and stats at the time of the run
music_id, music_title, music_author, music_is_original, music_duration_secThe sound
cover_url, video_play_url, video_download_url, video_width, video_heightCover and video addresses on TikTok's CDN, and the frame size
subtitle_languages, subtitle_urlCaption tracks TikTok offers for the post, and the first track (WebVTT)
is_ad, is_sponsoredTikTok's ad flag, and branded content or ad authorisation flags
keyword, search_rank, search_page, search_passThe keyword that found the post, its place in that keyword's results, the topic page number, and the topic page it came from
suggestion, suggestion_type, suggestion_rank, suggestion_depth, suggestion_group_id, parent_suggestionSuggestion rows: the text, autocomplete or related_question, its place, depth 1 or 2, TikTok's id and the suggestion it was found under
scraped_atWhen the row was written

Not returned: post language, repost count, tagged place and posting country. TikTok's topic pages do not carry them.

Summary row (_type: "summary", never charged): keywords_requested, keywords_with_rows, keywords_no_topic_page, keywords_blocked, topic_pages_read, raw_posts_seen, videos_delivered, suggestions_delivered, charged_for, duplicates_skipped, filtered_by_date, filtered_by_engagement, filtered_off_topic, same_author_skipped, bytes_megabytes (with kilobytes per delivered row), shortfall_reason when fewer rows came back than asked, and per_keyword, one entry per keyword with the topic pages it read (word, kind, pages, videos, delivered_or_pooled, off_topic, status), posts seen, rows delivered and why it stopped. The same summary is saved as the OUTPUT record of the run.

Stable fields for automations

These were present in every video row of our test runs (6,434 rows over 17 runs), and their names will not change:

FieldWhat it is
video_idThe key to store and join on
video_urlLink to the post
created_utcPosted time
duration_secVideo length
play_count, like_count, comment_count, share_count, save_countEngagement
author_username, author_idThe creator
author_followers, author_total_likes, author_video_countCreator stats
music_id, music_titleThe sound
keyword, search_rankWhat found it and where

Optional, present only when TikTok shows a value: description (99.8% of rows), cover_url (99.9%), hashtags (94%), video_download_url (80%), subtitle_languages and subtitle_url (48%), mentions (15%).

Output example

One video from the "skincare routine" lookup (test run, 10 Nov 2026, trimmed):

{
"result_type": "video",
"video_id": "7706263668698123533",
"video_url": "https://www.tiktok.com/@sabyhesri/video/7706263668698123533",
"description": "The dedication is real @Murad Skincare @Clean Skin Club @AveneUSA @anua_global @haruharu wonder @Tatcha @Dr.Althea US #skincare #morningskincare #morningroutine #azelaicacid #toner ",
"created_utc": 1794254366,
"created_at": "2026-11-09T19:59:26.000Z",
"duration_sec": 88,
"play_count": 66200,
"like_count": 3961,
"comment_count": 45,
"share_count": 65,
"save_count": 368,
"hashtags": [
"skincare",
"morningskincare",
"morningroutine",
"azelaicacid",
"toner"
],
"author_username": "sabyhesri",
"author_nickname": "sabyhesri",
"author_id": "6801520201114272774",
"author_url": "https://www.tiktok.com/@sabyhesri",
"author_verified": true,
"author_followers": 3600000,
"author_following": 252,
"author_total_likes": 96800000,
"author_video_count": 1535,
"music_id": "7089168469213939714",
"music_title": "Cave dripping water drops(1224628)",
"music_author": "kanekokasumi sounds",
"music_is_original": false,
"video_width": 720,
"video_height": 1280,
"is_ad": false,
"is_sponsored": false,
"keyword": "skincare routine",
"search_rank": 3,
"search_page": 1,
"search_pass": "topic: skincare-routine",
"scraped_at": "2026-11-10T15:24:45.391Z"
}

Pricing

Pay per event: you pay for the posts and suggestions you receive, plus a flat $0.003 per run, whatever memory you choose. Reading topic pages, sorting, filtering and deep search cost nothing extra.

EventWhen it is chargedFree planBronze (Starter)Silver (Scale)Gold (Business)
video-scrapedOnce per video row stored in your dataset$0.27 per 1,000$0.23 per 1,000$0.20 per 1,000$0.18 per 1,000
suggestion-scrapedOnce per suggestion row stored in your dataset$0.27 per 1,000$0.23 per 1,000$0.20 per 1,000$0.18 per 1,000
run-startOnce per run, after the first rows were delivered$0.003$0.003$0.003$0.003

The price of one row is the price per 1,000 divided by 1,000.

Never charged:

  • a post that a second keyword of the same run finds again;
  • posts dropped by minPlays, minLikes, uniqueAuthors, the date window or the on topic check;
  • posts past your maxItems;
  • the summary, info and error rows;
  • a run with no keyword, or one whose keywords have no topic page: the start fee is charged only once rows were delivered;
  • anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

Run it on a schedule

  1. Open the actor in Apify Console, set your input and click Save as a new task.
  2. In the task, open Schedules, click Add schedule and pick how often (every day, every Monday at 08:00 and so on).
  3. Use sortBy latest with datePosted last_24_hours or last_week and compare video_id between runs to see only new posts.
  4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

FAQ

What does this actor read?

TikTok's public topic pages (tiktok.com/discover/your-keyword), which any visitor can open without logging in, and the suggestions TikTok shows as you type. It does not log in, post, follow or read anything private.

No, and it says so on purpose. TikTok stopped serving its keyword search to visitors who are not logged in in late October 2026: a search from a logged out browser comes back with a login request instead of results. What a logged out visitor can still open is the topic page for a word, which lists about 90 videos. This actor reads that page for your keyword, written as a phrase and as one word, and with deep search the pages of the phrases TikTok suggests for it. The result is the videos TikTok shows for the topic, not the exact ranking of the search box in the app.

How many results can I get per keyword?

In our tests one topic page held about 70 to 99 posts and a popular keyword reached 514 ("lab grown diamond") and 713 ("skincare routine") on topic rows with deep search before it ran out of suggested phrases. Twelve ordinary keywords at maxItems 300 returned 300 rows each for 8 of them, 290 for "diwali decor", 234 for "cat videos", 154 for "korean skincare for oily skin" and 110 for "wedding jewellery". The summary row says how many rows each keyword returned and why it stopped.

Do the sort and date filters really work?

Yes, on the rows the actor found. most_liked returns the pool in falling order of likes, latest newest first, and datePosted drops everything older than the window (our last_month test returned posts 0 to 29 days old). TikTok's topic pages have no filter of their own, so a narrow window or a high minLikes leaves fewer rows than maxItems: 87 rows for two keywords at maxItems 50 with last_month and minLikes 1,000.

Why did I get fewer rows than maxItems?

Either TikTok has no more posts for that keyword (the summary row says results_exhausted), your minPlays, minLikes, datePosted or uniqueAuthors dropped rows, or two keywords found the same posts. A very specific phrase may have no topic page at all: the run then returns one info row, costs one request and charges nothing. Try the shorter, more popular phrase.

Can I search for users, hashtags or photo posts?

Not for users: TikTok does not serve user search results to a visitor who is not logged in. Photo posts are not on the topic pages (none in 1,229 posts we read), so there is no photo option. For a hashtag's own feed use TikTok Scraper: Hashtag, Search and Trending Videos.

United States. TikTok serves its logged out topic pages from its US servers to this kind of request, so the posts are the ones a US visitor sees, in any language.

Yes. cover_url, video_play_url, video_download_url and author_avatar_url are signed TikTok CDN links that expire within about a day, and the video links need TikTok session cookies to play. video_url is the permanent link. For a transcript use TikTok Transcript Scraper.

How long does a run take?

In our tests: 25 to 39 seconds for the "Try it" input (30 videos), 52 to 128 seconds for 300 rows of one keyword, 278 seconds for 1,902 rows across ten keywords and 169 seconds for 1,227 rows of two keywords at the deepest setting. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

Do I need an account, cookies or a proxy?

No. The actor handles its own requests and proxy. Nothing to set up.

Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has ready views for videos, creators, sounds and hashtags, and suggestions. In CSV and Excel, list fields such as hashtags are flattened into columns such as hashtags/0.

Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/tiktok-search-scraper

  • Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
  • ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
  • Cursor or VS Code: add it as an HTTP MCP server with that URL.
  • Claude Code: claude mcp add -t http tiktok-search-scraper "https://mcp.apify.com/?tools=themineworks/tiktok-search-scraper"

The actor reads only public pages that anyone can see without logging in. Creator names, usernames and avatars are personal data under GDPR, CCPA and similar laws: collect only what you need and have a lawful basis for processing it. You are responsible for how you use the data, including TikTok's terms. This is general information, not legal advice.

Integrations

  • Google Sheets: send each run's rows to a sheet with Apify's Google Sheets integration; one row per post fits a sheet as is.
  • Make, Zapier and n8n: start a run and read its dataset with the Apify apps and nodes, for example "new posts for our brand keyword every morning to Slack".
  • Webhooks: have Apify call your URL when a run succeeds, then fetch the dataset.
  • API and SDKs: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
  • MCP clients: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

More from The Mine Works

Social media and video

Leads and business directories

Marketing, SEO and reviews

LinkedIn

Real estate

Science, health and government data

Jobs and hiring

Company and business data

E-commerce and marketplaces

Food and local services

Developer and AI tools

More tools

Support

Found a keyword that returns fewer posts than you expect, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

Get the TikTok videos listed for any keyword as one row each, with plays, likes, comments, shares, saves, creator followers, sound and hashtags, sorted and date filtered, no login.