Tiktok Followers Api Scraper

Tiktok Followers Api Scraper

Tiktok Followers Api Scraper is a Playwright-powered Apify actor that loads TikTok profile pages, opens the followers modal, and extracts structured follower records aligned to a followers API shape. It solves the challenge of reliably collecting accurate follower lists at scale with automatic proxy fallback and clean, analysis-ready output — ideal for marketers, developers, data analysts, and researchers who want to scrape TikTok followers. As a focused tiktok followers api scraper and tiktok followers extractor, it enables repeatable workflows for influencer discovery, audience analysis, competitor tracking, and growth pipelines.

What data / output can you get?

Below are key fields the actor outputs (default mode). Field names mirror the real JSON keys produced by the actor.

Data type	Description	Example value
authorMeta.id	Follower’s TikTok user ID (stringified)	"7061234567890123458"
authorMeta.name	Follower handle (uniqueId)	"follower_handle"
authorMeta.profileUrl	Follower’s TikTok profile URL	"https://www.tiktok.com/@follower_handle"
authorMeta.nickName	Display name	"Follower Display"
authorMeta.verified	Verification status	false
authorMeta.signature	Bio/description	"Creator. Athlete. Coffee."
authorMeta.originalAvatarUrl	Full-size avatar URL	"https://p16-sign-va.tiktokcdn.com/obj/avatar.jpg"
authorMeta.privateAccount	Private account flag	false
authorMeta.following	Following count	321
authorMeta.fans	Followers (fans) count	5420
authorMeta.heart	Total likes/hearts	104500
authorMeta.video	Video count	27
connectedTo.name	Source profile handle (profile being scraped)	"sourceprofile"
connectedTo.profileUrl	Source profile TikTok URL	"https://www.tiktok.com/@sourceprofile"
connectedTo.commerceUserInfo.commerceUser	Source profile commerce flag	false
connectionType	Relationship type (fixed)	"following"
connectionDescription	Human-readable relationship summary	"sourceprofile is following follower_handle"

Notes:

• In “Simply Output” mode, only the follower’s authorMeta fields are returned at the top level, plus sourceProfile.
• Export your Apify dataset to JSON or CSV for analytics, integrations, and BI pipelines.

Key features

• ⚔️ Automatic proxy fallback
  Starts with no proxy and automatically falls back to datacenter and then residential proxies (with retries) if TikTok blocks access — a resilient tiktok followers crawler pattern for stability at scale.

• 🧱 Structured follower relationships
  Outputs a clean object per follower with authorMeta, connectedTo, connectionType, and connectionDescription — perfect for building a tiktok follower analytics API workflow.

• 🔀 Flexible Simply Output mode
  Toggle simplyOutput to return just the follower’s authorMeta fields plus sourceProfile — ideal when you want to download TikTok followers list quickly or power a tiktok followers export tool.

• 🧭 Playwright-powered navigation
  Opens the followers modal and scrolls it with anti-blocking tactics (random delays, overlay handling, force clicks) for reliable collection versus basic scrapers.

• 🔢 Precise collection limits
  Control the maximum number of followers per profile with maxFollowersPerProfile (1–5000) for repeatable, predictable runs across profiles.

• 🔌 Developer-ready on Apify
  Run on the Apify platform and access results via the Apify API — great for teams building a tiktok followers API pipeline or connecting this tiktok audience scraper to downstream systems.

• 📤 Easy dataset export
  Export to JSON or CSV for dashboards, CRMs, and warehouses; power tiktok competitor followers scraper use cases and enrichment flows.

• 🏭 Production-focused reliability
  Retries, smart waiting, and a robust proxy strategy make it suitable for ongoing tiktok followers monitoring and batch jobs.

How to use Tiktok Followers Api Scraper - step by step

1. Sign in to Apify Console and open the “tiktok-followers-api-scraper” actor.
2. In Input, provide one or both:
   • username: the TikTok handle (e.g., mrbeast), or
   • userUrl: the full profile URL (e.g., https://www.tiktok.com/@nike).
3. Add your TikTok session cookie sid_tt (required). Without it, TikTok does not return follower lists.
4. Set maxFollowersPerProfile (1–5000) to control how many follower records to collect per profile.
5. (Optional) Toggle simplyOutput if you only need the follower’s authorMeta fields plus sourceProfile.
6. (Optional) Configure proxyConfiguration. By default, the actor starts with no proxy and will automatically fall back to datacenter then residential if blocked.
7. Click Start. The actor navigates to the profile, opens the followers modal, and begins collecting followers.
8. When the run finishes, open the Dataset tab and export results as JSON or CSV.

Pro tip: Use the Apify API to schedule runs and feed results to your analytics stack — a robust way to scrape TikTok followers at scale and integrate your tiktok follower list scraper into automated pipelines.

Use cases

Use case name	Description
Marketing audience analysis	Measure follower composition and engagement signals with a tiktok followers data scraper to inform targeting and creative.
Influencer vetting & discovery	Extract follower lists and stats to assess creator fit and authenticity using a structured tiktok follower list scraper.
Competitor benchmarking	Track audience changes and overlaps by exporting to CSV for dashboards in your tiktok competitor followers scraper workflow.
Data enrichment pipelines	Enrich CRMs/data warehouses with authorMeta fields via the Apify API for scalable, automated updates.
Academic & social research	Collect public follower relationships and metrics for network analysis and studies.
API-driven monitoring	Orchestrate periodic runs to monitor audience shifts with a tiktok followers API pattern for time-series analysis.
Growth campaigns	Download TikTok followers list for seed audiences, outreach, or lookalike modeling within compliant workflows.

Why choose Tiktok Followers Api Scraper?

Built for precision, automation, and reliability, this actor focuses on clean follower relationship data at scale.

• ✅ Accurate, structured output aligned to a followers API shape (authorMeta, connectedTo, connectionType, connectionDescription).
• 🔁 Automatic proxy fallback (no proxy → datacenter → residential with retries) for resilient data collection.
• 🧩 Configurable limits (maxFollowersPerProfile up to 5000) for predictable runs.
• 🧑‍💻 Developer-friendly on Apify with dataset access via API for pipelines and integrations.
• 🔒 Session-based access using sid_tt ensures follower lists load while targeting public profiles.
• 📦 Fast export to JSON or CSV for analytics, CRMs, and data platforms.
• 🛡️ Production-grade navigation with retries and anti-blocking tactics.

Compared to fragile browser extensions or one-off scripts, this production-ready tiktok followers scraper delivers consistent, structured outputs you can trust.

Is it legal / ethical to use Tiktok Followers Api Scraper?

Yes — when used responsibly. This actor collects data from publicly accessible TikTok profiles and requires your authenticated session (sid_tt) because TikTok only returns follower lists to logged-in users. Always ensure you scrape public data, comply with applicable laws and regulations (e.g., GDPR, CCPA), respect TikTok’s terms, and avoid private or password-protected content. For edge cases, consult your legal team.

Input parameters & output format

Example JSON input

{
  "username": "mrbeast",
  "userUrl": "",
  "sid_tt": "YOUR_SID_TT_COOKIE_VALUE",
  "maxFollowersPerProfile": 150,
  "simplyOutput": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameter reference

• username (string) — Default: "mrbeast" — Required: No
  Enter the TikTok username (handle) to scrape. Do not include @ or URL.

• sid_tt (string) — Default: "" — Required: Yes
  TikTok session cookie. Required for follower lists to load.

• userUrl (string) — Default: "" — Required: No
  Full TikTok profile URL (e.g., https://www.tiktok.com/@nickiminai).

• maxFollowersPerProfile (integer) — Default: 100 — Required: No
  Maximum number of followers to collect per profile (1–5000).

• simplyOutput (boolean) — Default: false — Required: No
  If true, outputs only the follower’s authorMeta at the top level plus sourceProfile.

• proxyConfiguration (object) — Default: {"useApifyProxy": false} — Required: No
  Proxy settings. Actor starts with no proxy and automatically falls back to datacenter then residential if blocked.

Example JSON output (default mode: full object per follower)

[
  {
    "authorMeta": {
      "id": "7061234567890123458",
      "name": "follower_handle",
      "profileUrl": "https://www.tiktok.com/@follower_handle",
      "nickName": "Follower Display",
      "verified": false,
      "signature": "Creator. Athlete. Coffee.",
      "bioLink": "https://example.com",
      "originalAvatarUrl": "https://p16-sign-va.tiktokcdn.com/obj/avatar.jpg",
      "avatar": "https://p16-sign-va.tiktokcdn.com/obj/avatar.jpg",
      "privateAccount": false,
      "ttSeller": false,
      "followDatasetUrl": null,
      "following": 321,
      "friends": 12,
      "fans": 5420,
      "heart": 104500,
      "video": 27,
      "digg": 0
    },
    "connectedTo": {
      "id": "",
      "name": "sourceprofile",
      "profileUrl": "https://www.tiktok.com/@sourceprofile",
      "nickName": "sourceprofile",
      "verified": false,
      "signature": "",
      "bioLink": null,
      "originalAvatarUrl": "",
      "avatar": "",
      "commerceUserInfo": { "commerceUser": false },
      "privateAccount": false,
      "roomId": "",
      "ttSeller": false,
      "followDatasetUrl": null,
      "following": 0,
      "friends": 0,
      "fans": 0,
      "heart": 0,
      "video": 0,
      "digg": 0
    },
    "connectionType": "following",
    "connectionDescription": "sourceprofile is following follower_handle"
  }
]

Example JSON output (simplyOutput = true)

[
  {
    "sourceProfile": "sourceprofile",
    "id": "7061234567890123458",
    "name": "follower_handle",
    "profileUrl": "https://www.tiktok.com/@follower_handle",
    "nickName": "Follower Display",
    "verified": false,
    "signature": "Creator. Athlete. Coffee.",
    "bioLink": "https://example.com",
    "originalAvatarUrl": "https://p16-sign-va.tiktokcdn.com/obj/avatar.jpg",
    "avatar": "https://p16-sign-va.tiktokcdn.com/obj/avatar.jpg",
    "privateAccount": false,
    "ttSeller": false,
    "followDatasetUrl": null,
    "following": 321,
    "friends": 12,
    "fans": 5420,
    "heart": 104500,
    "video": 27,
    "digg": 0
  }
]

Notes:

• connectionType is always "following".
• Some fields (e.g., bioLink, roomId) may be null or empty if not present on the profile.
• Export your dataset as JSON or CSV for seamless integrations.

FAQ

Do I need to log in to use this tiktok followers scraper?

✅ Yes. You must provide a valid sid_tt cookie from a logged-in TikTok session. Without it, TikTok will not return follower lists and the actor exits early.

Can I export results to CSV or JSON?

✅ Yes. After the run completes, open the Dataset and export results as JSON or CSV for analysis or integrations such as dashboards and CRMs.

How many followers can I collect per profile?

📈 You control this with maxFollowersPerProfile, from 1 up to 5000. The actor scrolls the followers modal until it reaches your limit or no more users load.

Does it use proxies? Can I run without them?

🛡️ Yes. The actor starts with no proxy by default. If TikTok blocks requests, it automatically falls back to datacenter and then residential proxies with retries.

What data does the tiktok followers api–style output include?

🧩 Each follower includes authorMeta fields (id, name, profileUrl, nickName, verified, signature, avatar URLs, stats like following/friends/fans/heart/video/digg) plus connectedTo (source profile), connectionType, and connectionDescription. In simplyOutput mode, authorMeta is returned at the top level with sourceProfile.

Is this an official TikTok API for followers?

❌ No. It’s an automation-based extractor that navigates the site and parses responses to return follower lists, functioning as an unofficial tiktok followers API pattern.

Can developers integrate this into pipelines?

💻 Yes. Run on Apify and access datasets via the Apify API to wire results into your workflows — ideal for building a tiktok followers API pipeline or tiktok followers export tool.

Can it scrape private profiles?

⚠️ The actor targets public profiles and requires your authenticated session cookie to load follower lists. Availability of follower data depends on TikTok’s visibility rules for each profile.

Closing CTA / Final thoughts

Tiktok Followers Api Scraper is built for accurate, structured follower list extraction from public TikTok profiles. With automatic proxy fallback, configurable limits, and clean authorMeta outputs, it empowers marketers, analysts, researchers, and developers to turn follower data into insights fast. Use the Apify API to automate runs and feed downstream systems, from dashboards to data warehouses. Start extracting smarter follower insights and build your own tiktok follower analytics API workflows with a production-ready foundation.