TikTok Search Scraper

Turn any keyword or hashtag into a clean, structured feed of TikTok videos — with full engagement metrics, in seconds.

Search TikTok the way your audience does, then export every matching video with plays, likes, comments, shares, music, author, and more. No login, no browser babysitting, no rate-limit headaches. Just enter what you want and press Start.

Fast. Lightweight. Reliable. Built for marketers, analysts, agencies, and developers who need TikTok data at scale.

---

Why use this actor

• Find what's working right now — search any topic and instantly see the videos ranking for it.
• Measure real engagement — every video comes with plays, likes, comments, shares, saves, and duration.
• Track hashtags — pull the videos powering any hashtag, plus hashtag reach.
• Know the creators — optionally attach author followers, bio, and verified status to every video.
• Filter to what matters — keep only high-performing videos or recent uploads.
• Real-time delivery — results stream to your dataset as they're found, with optional instant webhook push.
• Zero setup — sensible defaults are prefilled; click Start and get results.

---

Use cases

Goal	How this actor helps
Content research	Discover the top-performing videos for any topic before you create.
Trend monitoring	Track a keyword or hashtag over time to spot what's rising.
Competitor & niche analysis	See who dominates a topic and how much engagement they pull.
Influencer discovery	Surface creators winning a niche, with follower counts attached.
Ad & campaign inspiration	Collect proven creative angles by keyword or hashtag.
Market & audience research	Quantify interest in a topic across regions.
Data pipelines & dashboards	Feed structured TikTok data into your BI, CRM, or warehouse.

---

What you get

• Keyword search — enter topics (e.g. cooking, gym tips, skincare) and collect the matching videos.
• Hashtag search — enter hashtag names (e.g. cooking, fyp) and collect the videos under them, plus hashtag info.
• Full engagement on every video: plays, likes, comments, shares, saves, duration, cover image, music, and download URL.
• Author details (optional): followers, following, total likes, bio, verified status, profile link.
• Filters: minimum play count and "published within" time window for keyword search.
• Region targeting: choose the market your results come from.
• Real-time webhook: POST each record to Slack, Zapier, Make, your CRM, or any custom API as it's collected.

---

Input

Configure the run from the visual form in Apify Console, or pass JSON via the API. Defaults are prefilled so you can run it immediately.

Search by keyword

Field	Type	Default	Description
enableKeywordSearch	boolean	true	Turn keyword video search on.
videoKeywords	string[]	["cooking","gym tips"]	Topics to search.
videoMaxResults	integer	20	Videos to collect per keyword (1–100).
videoKeywordFetchEngagement	boolean	true	Add plays, likes, comments, shares, music, duration, and cover to each video.
videoKeywordFetchAccountDetails	boolean	false	Add author followers, bio, and verified status to each video.
videoKeywordMinPlays	integer	0	Keep only videos at or above this play count (0 = no filter).
videoKeywordPublishedWithin	string	any	Keep only recent videos: any, 7d, 30d, or 90d.
tryClassicSearchApi	boolean	false	Widen keyword search to surface additional matching videos.

Search by hashtag

Field	Type	Default	Description
enableHashtagSearch	boolean	false	Turn hashtag search on.
hashtags	string[]	["cooking","fyp"]	Hashtag names, without #.
hashtagFetchVideos	boolean	true	Collect the videos under each hashtag (off = hashtag info only).
hashtagMaxVideos	integer	20	Videos per hashtag (1–50).
hashtagFetchEngagement	boolean	true	Add plays, likes, comments, shares, music, duration, and cover to each hashtag video.
hashtagFetchAccountDetails	boolean	false	Add author followers, bio, and verified status to each hashtag video.

Region & delivery

Field	Type	Default	Description
region	string	US	Market for search results (affects language and trending).
webhookUrl	string	—	Optional. Also POST every record to this URL in real time.
webhookFormat	string	json	json (full record) or slack (short message).
maxItems	integer	1000000	Safety ceiling on total rows.

Example input

{
  "enableKeywordSearch": true,
  "videoKeywords": ["cooking", "gym tips"],
  "videoMaxResults": 20,
  "videoKeywordFetchEngagement": true,
  "videoKeywordFetchAccountDetails": false,
  "videoKeywordMinPlays": 0,
  "videoKeywordPublishedWithin": "any",
  "enableHashtagSearch": false,
  "hashtags": ["cooking", "fyp"],
  "hashtagFetchVideos": true,
  "hashtagMaxVideos": 20,
  "region": "US"
}

---

Output

Each result is one structured record streamed to the run's dataset. Export as JSON, CSV, Excel, or HTML, or pull it straight from the Apify API. Use the featureType field to tell video and hashtag rows apart.

Example video record

{
  "featureType": "video",
  "videoSource": "keyword",
  "url": "https://www.tiktok.com/@chefexample/video/7623409201200598294",
  "videoId": "7623409201200598294",
  "description": "Quick weeknight pasta #cooking",
  "author": "chefexample",
  "authorNickname": "Chef Example",
  "playCount": 11900000,
  "diggCount": 799900,
  "commentCount": 1200,
  "shareCount": 500,
  "collectCount": 8300,
  "durationSec": 34,
  "musicTitle": "original sound",
  "musicAuthor": "chefexample",
  "hashtags": ["cooking"],
  "coverUrl": "https://...",
  "createTime": "2026-06-12T09:14:00.000Z",
  "searchQuery": "cooking",
  "region": "US",
  "scrapedAt": "2026-07-16T12:00:00.000Z",
  "engagementFetched": true,
  "accountFollowerCount": 774000,
  "accountVerified": true
}

Key fields

Field	Description
featureType	video or hashtag.
url / videoId	Direct link and ID of the video.
description	Video caption.
author / authorNickname	Creator username and display name.
playCount / diggCount	Plays and likes.
commentCount / shareCount / collectCount	Comments, shares, saves.
durationSec	Video length in seconds.
musicTitle / musicAuthor	Sound used.
hashtags	Hashtags on the video.
coverUrl / downloadUrl	Cover image and video download link.
createTime	When the video was posted.
searchQuery	The keyword or hashtag that surfaced this row.
accountFollowerCount / accountVerified / accountSignature	Author details (when enabled).

---

AI, LLM & MCP support

This actor is built to plug straight into AI agents and automation stacks:

• MCP (Model Context Protocol) — expose this actor as a tool to Claude, Cursor, and other MCP-compatible clients through the Apify MCP Server, so an assistant can search TikTok and reason over the results on your behalf.
• LLM-ready output — clean, flat JSON records that drop directly into RAG pipelines, agent tools, and function-calling workflows without extra parsing.
• Programmatic access — start runs and fetch results via the Apify API and official Python/JavaScript clients.
• Real-time webhooks — stream every record into your own agent or automation the moment it's found.

---

How to run

1. Open the actor in Apify Console.
2. Enter your keywords or hashtags (samples are prefilled).
3. Click Start.
4. Download your data as JSON, CSV, or Excel — or connect the API / webhook.

You can also schedule runs, chain it into workflows, or call it from your own code with the Apify API.

---

FAQ

Do I need a TikTok account or login? No. Just enter your keywords or hashtags and run.

What regions are supported? Set any market via the region field (e.g. US, GB, DE). It affects the language and trending of results.

Can I get results in real time? Yes. Records stream to the dataset as they're collected, and you can add a webhook to push each one instantly.

Is the output ready for spreadsheets and BI tools? Yes. Export to CSV/Excel, or pull structured JSON from the API into any dashboard or database.

---

Contact & custom work

Need a custom scraper, a data pipeline, or a web app built? I take on bespoke projects — from TikTok, Instagram, and marketplace scrapers to full-stack web applications and automations of any kind.

• Email: dubem115@gmail.com
• GitHub: github.com/DrunkCodes

Reach out with your idea and I'll help you build it.