Tiktok Search Scraper

Fast, stealthy TikTok Search Scraper for real-time video data extraction. Get captions, views, music, and author details for any query. Features advanced anti-block technology. Perfectly optimized for marketing research, trend tracking, and influencer analytics on the Apify platform.

What data can you extract?

The TikTok Search Scraper provides a comprehensive set of data points for every video result:

Field	Description
Video ID	The unique identifier for the video (id).
Video URL	The direct link to the TikTok video (url).
Description	The full caption, including hashtags and mentions (description).
View Count	The number of times the video has been played (views).
Likes	The number of likes the video has received (likes).
Comments	The number of comments on the video (comments).
Shares	The number of times the video has been shared (shares).
Author Info	Username (uniqueId), nickname, avatar URL, verification status (verified), and followers count (author).
Music Title	The song or sound used in the video (music).
Music Author	The creator of the music or sound used in the video (musicAuthor).
Hashtags	A list of hashtags included in the video (hashtags).
Duration	The length or duration of the video (duration).
Timestamp	The date and time the video was published (timestamp).
Scraped At	The exact date and time the data was extracted (scrapedAt).
Source	The method or source used to extract the data (source).

🔧 Configuration (Input)

Configure the actor from the Input tab on the Apify Console. All fields are available through the visual form; no code is needed.

Input reference

Field	Type	Required	Default	Description
queries	string array	✅ Yes	—	One or more TikTok search terms
maxItems	integer	No	5	Max videos to collect per query (1–10,000)
proxyConfiguration	object	No	Residential	Apify Proxy settings
sessionCookies	string (JSON)	No	—	Real browser cookies to bypass datacenter blocks
customProxyUrl	string	No	—	Route traffic through your own proxy/machine

---

queries — Search Queries

Enter one or more search terms. The actor runs an independent search for each query and collects up to maxItems videos per query.

In the Apify Console UI, click + Add item and type each term:

AI coding
tech review
laptop unboxing

In JSON / API input:

{
  "queries": ["AI coding", "tech review", "laptop unboxing"]
}

Tip: Use specific, niche phrases (e.g., "sustainable fashion haul") rather than broad single words to get more targeted results.

---

maxItems — Max Items

Sets the maximum number of video results to collect per query. The actor stops as soon as this limit is reached, or when TikTok has no more results to show.

• Minimum: 1
• Maximum: 10000
• Default: 5

For a quick trend check, 20–50 results is usually sufficient. For market research or training datasets, set this to 500–2000.

---

proxyConfiguration — Proxy Settings

TikTok blocks all requests from cloud datacenter IPs (including Apify's). You must route traffic through a residential or home IP to get results on the Apify platform.

Recommended: Select Residential proxies in the Apify Console proxy picker:

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Residential proxies use IPs assigned to real households, making your traffic indistinguishable from a regular TikTok user. See Apify Proxy docs for pricing and setup.

If you cannot purchase residential proxies, see the Advanced — Datacenter IP Bypass section below for two free alternatives.

---

Advanced — Datacenter IP Bypass

These two optional fields appear under the Advanced — Datacenter IP Bypass section in the Apify Console. Either can replace the need for residential proxies. Using both together gives the highest success rate.

sessionCookies — Session Cookies

Paste the JSON cookie array exported from your real TikTok browser session. This injects authenticated session tokens (msToken, ttwid, s_v_web_id) directly into the scraper. TikTok's trust-scoring system treats these tokens as coming from a real browser, significantly reducing the risk of an IP-based block.

Step-by-step export guide:

1. Install the free Cookie-Editor extension for Chrome or Firefox.
2. Open https://www.tiktok.com and browse normally for ~30 seconds — scroll the feed, watch a video.
3. Click the Cookie-Editor icon in your browser toolbar.
4. Click Export → Export as JSON.
5. Copy the entire JSON array that appears.
6. Paste it into the Session Cookies field in the Apify Console.

The actor normalises the cookie format automatically and skips the homepage warm-up visit so your higher-trust tokens are not overwritten by datacenter-seeded ones.

⚠️ Cookies expire — usually within a few hours to a few days. If the actor starts returning zero results, re-export and update this field. The actor also saves fresh cookies after every successful run and reloads them automatically on the next run, so you only need to re-export manually when results stop.

customProxyUrl — Custom Proxy URL

Route all actor traffic through a proxy server running on your own machine so TikTok sees your home IP instead of Apify's datacenter IP. When this field is set it takes priority over the Proxy Configuration panel above.

Accepted formats:

socks5://host:port
socks5://user:pass@host:port
http://host:port
http://user:pass@host:port

Free setup using microsocks + ngrok:

# 1. Start a local SOCKS5 proxy on your machine
#    macOS / Linux:
brew install microsocks    # or: sudo apt install microsocks
microsocks -p 1080

#    Windows (Node.js alternative):
npm install -g node-socks5-server
socks5-server --port 1080

# 2. Expose it to the internet with a free ngrok TCP tunnel
#    (sign up at https://ngrok.com — free tier supports TCP)
ngrok tcp 1080
# ngrok prints: Forwarding  tcp://0.tcp.ngrok.io:12345 → localhost:1080

# 3. Paste this into the "Custom Proxy URL" field:
socks5://0.tcp.ngrok.io:12345

⚠️ Your machine must remain running and connected while the actor is active. ngrok free-tier tunnels also reset on restart, so update the URL if you restart ngrok.

Best results tip: Combine both bypass options — inject real session cookies and route through your home IP. TikTok sees an established session arriving from a residential IP, which is indistinguishable from a real user.

📦 Data Output

Each results includes:

[
    {
    "id": "7580436....",
    "url": "https://www.tiktok.com/@techwithlesedi/video/7580436....",
    "description": "Comment \"tech\" if you w...",
    "views": "11K",
    "likes": "",
    "comments": "",
    "shares": "",
    "author": {
      "uniqueId": "tech...",
      "nickname": "tech...",
      "avatar": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/9....4~tplv-tiktokx-cropcenter:100:100.jpeg...",
      "verified": false,
      "followers": ""
    },
    "music": "Lesedi w...",
    "musicAuthor": "",
    "hashtags": ["technology", "AI", "Machine Learning", "Data Science", "Software Engineering", "Web Development", "Mobile Development", "Cloud Computing", "Cybersecurity", "Blockchain", "Internet of Things", "Virtual Reality", "Augmented Reality", "Robotics", "Automation"],
    "duration": "2025-12-5",
    "timestamp": "5 days ago",
    "scrapedAt": "2026-03-21T10:47:10.773Z",
    "source": "dom"
  },
  ...
]

Related Actors

Expand your data collection capabilities with these other powerful Apify Actors developed by the same author:

Zillow Scraper

• URL: https://apify.com/eunit/zillow-scraper
• Description: This general Zillow Scraper extracts data for properties for sale, for rent, or recently sold on Zillow. Use this Actor for broad market research or historical data collection across all property types.

Enhanced Twitter (X) Bot

• URL: https://apify.com/eunit/enhanced-twitter-x-bot
• Description: A versatile Twitter bot for powerful social media automation. This tool uses the Twitter API to auto-like, auto-follow, and manages your followers. Configure keywords, schedules, and safety limits for effective Twitter engagement and account growth.

Target Product Reviews Scraper

• URL: https://apify.com/eunit/target-reviews-scraper
• Description: A tool for market research and e-commerce analysis. Scrape product reviews, star ratings, and consumer sentiment from Target.com, useful for businesses analyzing the retail landscape in target neighborhoods.

Your feedback

We are always working on improving the performance of our Actors. So if you’ve got any technical feedback for the Tiktok Search Scraper Actor or simply found a bug, please create an issue on the Actor’s Issues tab in Apify Console.

Learn more about this Actor

📄 How to scrape TikTok search results: A complete guide for 2026