TikTok Scraper - Profiles, Videos, Hashtags & Search

TikTok Scraper: videos and profiles by handle, hashtag, keyword or link

One actor for four ways into TikTok. Give it handles, hashtags, search terms or pasted links and you get flat rows back: videos with plays, likes, comments, shares and saves, the caption, the sound, the author and the file links, and profiles with followers, lifetime likes, bio and the verified flag. Nothing to log into.

The limit to know before you spend anything: a profile returns about a dozen rows, the profile itself plus its ten or eleven newest videos. That is what TikTok publishes for a creator to a signed-out visitor, and no value of resultsPerPage gets past it. Hashtags and keyword searches page much deeper, so those are the modes to use when you want volume.

🔍 What TikTok Scraper does

Four modes, and you can mix them in one run:

resultsPerPage is the total for the whole run, not per input, which matters when you list several: once the first hashtag has used the allowance, the second returns nothing. Run them separately if you want a fair split.

Rows are deduplicated inside a run, so a video appearing under two of your hashtags is returned and billed once. maxRunSeconds stops a slow feed and hands back what it has so far, which keeps a pathological search from running up a bill.

📥 What you give it

{
  "profiles": ["nasa"],
  "hashtags": ["spacex"],
  "resultsPerPage": 50,
  "maxRunSeconds": 90
}

Run it with nothing at all and you get one labelled sample row, free, so you can see the shape first.

📤 What you get back

A real video row from a real run. The caption ends with an emoji, so it is cut short here, and the media links are trimmed:

{
  "ok": true,
  "type": "video",
  "id": "7358577498319342891",
  "webVideoUrl": "https://www.tiktok.com/@francov9/video/7358577498319342891",
  "text": "Got me feeling like Snow White and shii... #fyp #cats #disneyprincess",
  "createTime": "2024-04-16T21:19:04.000Z",
  "hashtags": ["fyp", "cats", "disneyprincess"],
  "region": "US",
  "playCount": 17912733,
  "diggCount": 3674504,
  "commentCount": 12854,
  "shareCount": 244131,
  "collectCount": 282047,
  "downloadCount": 8092,
  "isAd": false,
  "video": { "duration": 11, "cover": "https://p16-common-sign.tiktokcdn-us.com/...", "playAddr": "https://v45.tiktokcdn-us.com/...", "downloadAddr": "https://v45.tiktokcdn-us.com/..." },
  "music": { "id": "7402610556690860833", "title": "kagefumi", "authorName": "-", "original": true, "duration": 36 },
  "author": { "id": "6806757644620350470", "uniqueId": "francov9", "nickname": "Franco V.", "avatar": "https://p19-common-sign.tiktokcdn-us.com/..." }
}

Check type to tell the two shapes apart.

🧾 Reading the output

Three kinds of row can land in your dataset.

Filter on ok == true and you have your data. NOT_FOUND means TikTok showed the handle, video or tag as gone or private. BAD_INPUT means a handle carried characters TikTok does not use. RATE_LIMITED, BLOCKED, SERVER_ERROR and NETWORK all mean that item would not answer this run, which re-running usually clears. NO_RESULTS is the row you get when nothing came back at all. None of them is charged, and the run carries on to the next input.

One quirk of the Overview table: its columns are the video ones, so a profile row shows almost nothing there and a diagnostic reads as a blank line. Open the row itself or download the JSON and everything is present.

▶️ How to run it

1. Open TikTok Scraper and click Try for free. 2. Fill in whichever box fits: Profiles, Hashtags, Search queries or Start URLs. 3. Set Max videos per input. It is the total for the run, so start at 50 while you look at the output shape. 4. Click Start. 5. Download the dataset as JSON, CSV or Excel, or pull it from the Apify API.

💰 How much does it cost?

$0.25 per 1,000 rows. Flat on every Apify plan, no volume tiers. A profile row and a video row cost the same.

You pay for rows that carry data. The sample row, diagnostic rows and duplicates caught inside a run are not charged. resultsPerPage is the ceiling on both the rows and the spend.

💡 What people use it for

• Watching a set of creators: run the handles weekly and diff the counts on their newest videos.
• Pulling everything under a campaign hashtag, then reading the captions for how people talk about it.
• Keyword research: search a phrase and see which videos TikTok actually surfaces for it.
• One-off checks on a single video from a link somebody dropped in a channel.

🚧 What it does not do

• A profile is not an archive. About a dozen rows per handle, and no input value changes that.
• No comments, followers or reply threads. Comments are a separate actor, linked below.
• The limit is shared across your inputs. One greedy hashtag can use the whole run.
• A private account still costs you its profile row. You get the profile, then a NOT_FOUND

row telling you the videos are private.

• A video row can arrive with null counters when only the short public entry was available,

and it is still a delivered row.

• A missing counter on hashtag and search rows reads as 0.
• maxRunSeconds cuts quietly. When it fires you get a partial result and no row saying so, so

check the log if a count looks short.

• Media links expire. They are signed and short lived. Fetch the file during the run if you

want to keep it.

🧭 Which TikTok scraper do you need?

❓ Questions people ask

Why did a profile only return 12 rows? Because that is what TikTok publishes for a creator to a signed-out visitor. The limit is TikTok's, not the actor's.

Is resultsPerPage per input or per run? Per run. The field reads "Max videos per input", but the number you set is the total the run will deliver.

Can I get every video an account ever posted? No signed-out route reaches the full back catalogue. Hashtag and search modes are where the depth is.

What happens when a run hits maxRunSeconds? It stops and keeps what it already collected. You are charged for the rows you got and nothing else.

Is scraping TikTok legal? This reads public profiles and public videos only, never private accounts or messages. Results can still contain personal data, which GDPR and similar laws cover, so have a reason for collecting it. Apify's write-up on the legality of web scraping is a good starting point, and we are not lawyers.

Can I run it on a schedule? Yes. Use Apify's scheduler, or start it from the API and read the dataset when it finishes.

🆘 If something breaks

Open the Issues tab on the actor page. Include the handles, tags or links you used and the run ID, and the log is usually enough for us to see what happened.