# TikTok Search Scraper: Videos by Keyword, Sort and Date (`themineworks/tiktok-search-scraper`) Actor

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.

- **URL**: https://apify.com/themineworks/tiktok-search-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Social media, Videos, Marketing
- **Features:** Limited permissions
- **Stats:** 23 total users, 11 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.18 / 1,000 videos

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

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

[![30 TikTok videos for one keyword with plays, likes, creator followers and music, 25 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/tiktok-search-scraper-hero.png)](https://console.apify.com/actors/kgU8rdztoHBrbHTsZ/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

From **The Mine Works**, makers of [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), 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](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/kgU8rdztoHBrbHTsZ/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Social media and video family:** [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### 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:

```json
{
  "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

```text
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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `searchQueries` | array of strings | `["skincare routine"]` | Keywords, one lookup each. A `tiktok.com/search` link also works. Up to 100. |
| `contentType` | string | `videos` | `videos` or `suggestions` (suggestions only). |
| `maxItems` | integer | `50` | Most posts per keyword, 1 to 1,000. A popular keyword has about 500 to 700 on topic posts in all. |
| `sortBy` | string | `relevance` | `relevance` (TikTok's order), `most_liked` or `latest`. |
| `datePosted` | string | `any` | `any`, `last_24_hours`, `last_week`, `last_month`, `last_3_months` or `last_6_months`. |
| `deepSearch` | boolean | `true` | Also read the topic pages of the phrases TikTok suggests for the keyword when one page ends before `maxItems`. |
| `uniqueAuthors` | boolean | `false` | Keep only the first post of each creator across the run. |
| `minPlays` | integer | empty | Skip posts with fewer plays. Skipped posts are not charged. |
| `minLikes` | integer | empty | Skip posts with fewer likes. Skipped posts are not charged. |
| `includeSuggestions` | boolean | `false` | Add suggestion rows for each keyword next to the posts. |
| `suggestionDepth` | integer | `1` | 1 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.

| Field | What it is |
|---|---|
| `result_type` | `video` or `suggestion` |
| `video_id`, `video_url` | TikTok post id and its permanent link |
| `description` | Caption |
| `created_utc`, `created_at` | Posted time, Unix seconds and ISO 8601 UTC |
| `duration_sec` | Video length |
| `play_count`, `like_count`, `comment_count`, `share_count`, `save_count` | Engagement counts, exact figures |
| `hashtags`, `mentions` | Hashtags and mentioned usernames from the caption, without the symbols |
| `author_username`, `author_nickname`, `author_id`, `author_sec_uid`, `author_url`, `author_avatar_url` | The creator and the profile link |
| `author_verified`, `author_followers`, `author_following`, `author_total_likes`, `author_video_count` | Creator badge and stats at the time of the run |
| `music_id`, `music_title`, `music_author`, `music_is_original`, `music_duration_sec` | The sound |
| `cover_url`, `video_play_url`, `video_download_url`, `video_width`, `video_height` | Cover and video addresses on TikTok's CDN, and the frame size |
| `subtitle_languages`, `subtitle_url` | Caption tracks TikTok offers for the post, and the first track (WebVTT) |
| `is_ad`, `is_sponsored` | TikTok's ad flag, and branded content or ad authorisation flags |
| `keyword`, `search_rank`, `search_page`, `search_pass` | The 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_suggestion` | Suggestion rows: the text, `autocomplete` or `related_question`, its place, depth 1 or 2, TikTok's id and the suggestion it was found under |
| `scraped_at` | When 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:

| Field | What it is |
|---|---|
| `video_id` | The key to store and join on |
| `video_url` | Link to the post |
| `created_utc` | Posted time |
| `duration_sec` | Video length |
| `play_count`, `like_count`, `comment_count`, `share_count`, `save_count` | Engagement |
| `author_username`, `author_id` | The creator |
| `author_followers`, `author_total_likes`, `author_video_count` | Creator stats |
| `music_id`, `music_title` | The sound |
| `keyword`, `search_rank` | What 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):

```json
{
  "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.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `video-scraped` | Once 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-scraped` | Once 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-start` | Once 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.

#### Is this TikTok's own search?

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](https://apify.com/themineworks/tiktok-hashtag-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

#### Which countries does it search?

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.

#### Do the video and cover links expire?

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](https://apify.com/themineworks/tiktok-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

#### 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"`

#### Is it legal to scrape TikTok?

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**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Twitter / X Scraper](https://apify.com/themineworks/twitter-x-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [YouTube Transcript](https://apify.com/themineworks/youtube-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Xiaohongshu (RED) Scraper](https://apify.com/themineworks/xiaohongshu-explore-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Pinterest Profile Scraper](https://apify.com/themineworks/pinterest-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### 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.*

# Actor input Schema

## `searchQueries` (type: `array`):

What to look up, one keyword or phrase per line, as you would type it in the TikTok search box. Example: skincare routine, lab grown diamond, air fryer recipes. The actor reads TikTok's public topic page for each phrase. Broad, popular phrases work best. Up to 100 keywords per run.

## `contentType` (type: `string`):

Videos (default), or only the search suggestions TikTok shows for each keyword. TikTok's topic pages list videos; photo posts (slideshows) are not available.

## `maxItems` (type: `integer`):

The most videos (or photo posts) to return for each keyword, 1 to 1,000. One TikTok topic page lists about 85 to 100 posts; with Deep search on, TikTok's related topics add more for popular keywords. Example: 200.

## `sortBy` (type: `string`):

Relevance keeps TikTok's own order. Most liked puts the best performing posts first and Latest the newest first, applied to the posts found for the keyword.

## `datePosted` (type: `string`):

Only posts from this period. Combine with Most liked to find the best posts of the week. Posts outside the period are skipped and not charged.

## `deepSearch` (type: `boolean`):

One TikTok topic page lists about 85 to 100 posts. With this on, a keyword that ends before your maximum also reads TikTok's related topic pages (about 14 of them), and the new posts are added. Posts are never delivered or charged twice. Off: only the page for your own phrase.

## `uniqueAuthors` (type: `boolean`):

Keep only the first (highest ranked) post of each creator across the whole run. Useful to build a list of creators who post about a topic.

## `minPlays` (type: `integer`):

Skip posts with fewer plays than this. Skipped posts are not charged. Leave empty for no minimum. Example: 10000.

## `minLikes` (type: `integer`):

Skip posts with fewer likes than this. Skipped posts are not charged. Leave empty for no minimum. Example: 500.

## `includeSuggestions` (type: `boolean`):

Adds TikTok's autocomplete suggestions and related questions for each keyword as extra rows (result_type suggestion). Each suggestion row is charged as its own small event.

## `suggestionDepth` (type: `integer`):

1: the suggestions for your keyword (about 12). 2: also the suggestions for each of its first 10 autocomplete suggestions, about 55 rows per keyword for keyword research.

## Actor input object example

```json
{
  "searchQueries": [
    "skincare routine"
  ],
  "contentType": "videos",
  "maxItems": 30,
  "sortBy": "relevance",
  "datePosted": "any",
  "deepSearch": true,
  "uniqueAuthors": false,
  "includeSuggestions": false,
  "suggestionDepth": 1
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "skincare routine"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/tiktok-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["skincare routine"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/tiktok-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "skincare routine"
  ],
  "maxItems": 30
}' |
apify call themineworks/tiktok-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/tiktok-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/kgU8rdztoHBrbHTsZ/builds/NSsj2AmSfBiU4YfzV/openapi.json
