🎵 TikTok Profile Scraper (Private & Public)

Scrape any TikTok profile — public or private — in seconds. Hand the actor a list of URLs or @handles and get back a tidy dataset row per profile: followers, following, likes, video count, bio, avatar, verification, and more.

⚡ Built for speed. 🛡️ Built for survival. 🎯 Built for accuracy.

---

💡 Why this Actor?

• 🚀 Lightning fast — concurrent requests, real-time results streamed straight into your dataset.
• 🛡️ Self-healing proxy ladder — starts on a direct connection, automatically escalates to a 🛰️ datacenter proxy, then a 🏠 residential proxy if TikTok pushes back.
• 🤖 Browser-grade fingerprinting — powered by impit for TLS/HTTP fingerprints that look like a real Chrome.
• 🔄 Dual-source extraction — tries the full TikTok profile page first, transparently falls back to the embed endpoint when TikTok serves a stripped shell.
• 🛟 Overflow-safe counts — recovers 32-bit wrapped counts so creators with billions of likes still report correctly.
• 🪶 Clean output — one dataset row per profile, ready for CSV / JSON / Excel export.

---

🔑 Key features

• 📥 Bulk input — paste hundreds of profiles at once.
• 🌐 Smart proxy escalation — sticky once it kicks in, so you never bounce between tiers.
• 🧵 Concurrency control — tune how aggressive the scraper is.
• 🔁 Retries with backoff — 3 retries on residential by default, exponential cooldown.
• 📡 Live progress — engaging real-time status messages and per-profile result lines.
• 🛟 Partial success — one bad URL never kills the run; failed rows are surfaced with an error field.

---

🧩 Input

Field	Type	Description
urls	array	TikTok profile URLs, @handles, or plain handles. Required.
tiktokSource	enum	user (recommended) or embed. Defaults to user.
proxyConfiguration	object	Defaults to no proxy. The actor escalates automatically when blocked.
concurrency	integer	Profiles in parallel (1–20). Default 5.
maxRetries	integer	Retries per profile on residential tier (1–10). Default 3.
requestTimeoutSecs	integer	Per-request timeout (5–120s). Default 30.

{
  "urls": [
    { "url": "https://www.tiktok.com/@mrbeast" },
    { "url": "https://www.tiktok.com/@charlidamelio" }
  ],
  "tiktokSource": "user",
  "proxyConfiguration": { "useApifyProxy": false },
  "concurrency": 5,
  "maxRetries": 3,
  "requestTimeoutSecs": 30
}

---

📤 Output

One row per profile, pushed to the default dataset live as the run progresses.

{
  "url": "https://www.tiktok.com/@mrbeast",
  "username": "mrbeast",
  "tagline": "MrBeast",
  "following": { "raw": 351, "formatted": 351 },
  "followers": { "raw": 127615276, "formatted": "127.6M" },
  "likes":     { "raw": 1303707890, "formatted": "1.3B" },
  "videos":    { "raw": 460, "formatted": 460 },
  "bio": "Watch my latest video! 👇",
  "image": "https://p16-common-sign.tiktokcdn.com/...jpeg",
  "public_profile": true,
  "requestUrl": "https://www.tiktok.com/@mrbeast"
}

Field	Meaning
url	Canonical TikTok profile URL.
username	Resolved TikTok handle (without the @).
tagline	Display name shown on the profile.
following / followers / likes / videos	{raw, formatted} pair for every stat.
bio	Profile signature / bio text.
image	Highest-resolution avatar URL available.
public_profile	true for open accounts, false for private ones.
requestUrl	The exact endpoint that finally produced the data.

If a profile cannot be retrieved, the row contains username, url, and error instead — so partial success is preserved.

---

🛡️ How the proxy ladder works

By default the actor sends requests with no proxy. If TikTok rejects the request:

1. 🛰️ Datacenter proxy — the actor switches to Apify's datacenter group and retries.
2. 🏠 Residential proxy — if datacenter is still blocked, the actor escalates to residential proxies with up to 3 retries and exponential backoff.
3. 🔒 Sticky tier — once a tier escalation happens, every remaining request uses the higher tier. You never bounce back to a lower tier mid-run.

Every escalation is logged clearly so you can see exactly when and why the connection upgraded.

---

🚀 How to use the Actor (via Apify Console)

1. 🔑 Log in at console.apify.com → Actors.
2. 🔎 Find TikTok Profile Scraper (Private & Public) and click it.
3. ⚙️ Configure inputs — paste your URLs / handles, tweak proxy and concurrency if needed.
4. ▶️ Click Start.
5. 📡 Watch the live log — you'll see each profile resolved as it lands.
6. 📊 Open the Output tab for results.
7. 📦 Export to JSON / CSV / Excel / XML / HTML.

---

🎯 Best use cases

• 📈 Creator analytics — track follower / like growth across a portfolio.
• 🤝 Influencer marketing — vet profiles in bulk before outreach.
• 🛒 E-commerce / DTC research — find creators in your niche.
• 🧪 Trend research & data journalism — gather public profile snapshots at scale.

---

❓ Frequently asked questions

Does it work for private profiles? It returns the same metadata TikTok shows on the profile shell (username, display name, follower / like / video counts when public, avatar, public_profile: false). Posts inside private accounts are not exposed.

Why are some counts shown as 1.3B instead of the exact number? Each stat has both raw (exact integer) and formatted (human-readable). Use whichever fits your workflow.

TikTok blocked my IP — what do I do? Nothing — the actor automatically escalates to a datacenter, then a residential proxy. You'll see a 🔁 Connection escalated → ... line in the log.

Can I plug this into n8n / Make / Zapier? Yes — Apify integrates with all of them. Run the actor on a schedule and pipe the dataset wherever you need it.

---

🛟 Support & feedback

Found a bug or want a new field? File an issue on the Actor's Issues tab in Apify Console. Pull requests welcome.

---

⚖️ Legal & ethical use

This actor only collects publicly available profile metadata that TikTok itself displays to anyone who visits the page. You are responsible for complying with TikTok's Terms of Service and any applicable data-protection laws (GDPR / CCPA / etc.) when using the output.