Skip to content

September 24, 2026 · 13 min read

TikTok Followers & Following Scraper: 17 Data Fields per Record (2026)

By Crawlerbros Engineering Team

Extract the followers and following lists for any TikTok profile across 17 output fields per user, including usernames, display names, bios, avatars, and engagement metrics. Each record captures details such as verification status, organization flags, and statsV2 counts. A thousand results costs $5.00 on the free plan, which covers up to 1,000 results with no credit card required. The following list works without cookies, while harvesting followers requires a sessionCookie to fetch authentic records. This is built for social media analysts, market researchers, and talent scouts, but is not for anyone who needs to scrape private account following lists.

Try it before you read further. Apify's free plan includes $5.00 of usage every month with no credit card, enough for up to 1,000 results at $0.005 each before platform usage. Open TikTok Followers & Following Scraper on Apify and run the prefilled example.

How reliable is TikTok Followers & Following Scraper in production?

Across the last 30 days of public runs on the Apify platform, TikTok Followers & Following Scraper recorded 62 runs with the following outcomes.

Outcome Runs Share
Succeeded 59 95.2%
Failed 1 1.6%
Aborted by the user 2 3.2%
Timed out 0 0.0%
Total 62 100.0%

Expect about 2 runs in a hundred to fail or time out during unattended execution. Build retry logic around larger extraction batches to handle these intermittent drops gracefully. User-aborted runs represent manual cancellations rather than underlying technical errors.

What does it cost to run TikTok Followers & Following Scraper?

Each result costs $0.005 on Apify's free plan, which is $5.00 per 1,000 results. Starting a run is charged separately at $0.005 per GB of Actor memory. Apify also bills the platform usage each run consumes, at the rates of your Apify plan, on top of these charges.

Apify plan Per result Per 1,000 results
FREE $0.005 $5.00
BRONZE $0.00433 $4.33
SILVER $0.00367 $3.67
GOLD $0.003 $3.00
PLATINUM $0.003 $3.00
DIAMOND $0.003 $3.00

Worked example: collecting 10,000 results costs $50.00 in result charges before run-start fees and platform usage. With 1.6% of runs failing or timing out in the last 30 days, budget for re-running a portion of those batches rather than assuming every run completes.

The primary cost driver is the maxUsersPerProfile control paired with the number of target usernames, as result charges apply to every item written to the dataset. Evaluate the output before scaling by running a small test with maxUsersPerProfile capped at 30. Apify's free plan provides $5.00 of monthly usage to cover initial evaluations.

How do you run TikTok Followers & Following Scraper from the API?

None of its 6 controls is strictly required, so the defaults below produce a valid run on their own. Every value in the payload below comes from the published schema's own prefills, which means you can paste it, swap the token, and get a real result.

Call the synchronous endpoint to start a run and receive dataset items in one request:

curl -X POST "https://api.apify.com/v2/acts/crawlerbros~tiktok-followers-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"listType":"following","maxUsersPerProfile":30,"includeStats":true}'

The same run from Python, using the official client:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")

run_input = {
  "usernames": [
    "natgeo"
  ],
  "listType": "following",
  "maxUsersPerProfile": 30,
  "includeStats": True
}

run = client.actor("crawlerbros~tiktok-followers-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

And from Node.js:

import { ApifyClient } from 'apify-client'

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' })

const input = {
  "usernames": [
    "natgeo"
  ],
  "listType": "following",
  "maxUsersPerProfile": 30,
  "includeStats": true
}

const run = await client.actor('crawlerbros~tiktok-followers-scraper').call(input)
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)

That endpoint blocks until the run completes. Fine while you are testing a handful of records, risky once a run takes minutes: a dropped connection loses the response even though the run itself finished. Switch to an asynchronous start with polling or a webhook before you schedule anything.

Which TikTok Followers & Following Scraper inputs matter, and which can you skip?

The usernames and profileUrls controls define your target accounts, while listType switches between followers, following, or both modes. Keep includeStats enabled on your first run and adjust maxUsersPerProfile to control the volume of items returned per profile.

  • usernames (array): TikTok usernames (with or without @) to fetch followers/following for.
  • profileUrls (array): TikTok profile URLs as alternative or additional input. E.g. https://www.tiktok.com/@natgeo
  • listType (string): Choose whether to scrape followers, following, or both lists for each profile. NOTE: 'followers' requires a sessionCookie - without it TikTok's API returns a generic list, not the account's real followers. 'following' works without a cookie. Default: "following".
  • maxUsersPerProfile (integer): Maximum number of follower or following users to fetch per profile. Default: 100.
  • includeStats (boolean): Include follower/following/heart/video counts from statsV2 for each user in the output. Default: true.
  • sessionCookie (string): Value of the TikTok sessionid cookie. Required to scrape followers - without it, TikTok's API ignores the target account and returns a generic regional list. Not needed for 'following' mode. To obtain: install Cookie-Editor extension → log into TikTok → click Cookie-Editor → find 'sessionid' → copy its Value.

Fixed-choice controls: listType accepts followers (Followers only (requires sessionCookie)), following (Following only), both (followers needs sessionCookie).

What does TikTok Followers & Following Scraper return?

Returned records provide structured profile data including unique identifiers, handles, follower counts, and heart counts. They are ideal for audience segmentation and creator discovery, but conspicuously omit private account data and buyer contact details.

  • sourceUsername - the profile that was queried
  • sourceUserId - TikTok user ID of the queried profile
  • listType - "followers" or "following"
  • userId - TikTok user ID (18-19 digit string)
  • secUid - TikTok secUid for API calls
  • username - TikTok @handle
  • displayName - display name / nickname
  • verified - whether this user has a verified badge
  • isOrganization - whether this is a business/organization account
  • privateAccount - whether this account is private
  • bio - profile bio/signature text
  • avatarUrl - avatar image URL
  • followerCount - number of followers (from statsV2)
  • followingCount - number of accounts this user follows (from statsV2)
  • heartCount - total likes received across all videos (from statsV2)
  • videoCount - number of public videos posted (from statsV2)
  • scrapedAt - ISO 8601 timestamp when the record was collected

These are the documented fields. Optional ones can be empty on a given record, so measure how often each field your deliverable depends on is populated across a real sample before automating the handoff.

How do you build the workflow end to end?

Open TikTok Followers & Following Scraper and work through these in order. Each step ends with something to check, so a bad configuration surfaces on a small run rather than a scheduled one.

  1. Run once with listType set to following and a single profile in usernames, then check that the returned records contain listType set to following before widening the input array.
  2. Set maxUsersPerProfile to 30 for the initial test run to cap results at 30 items and limit result charges to $0.15.
  3. To test the followers mode, provide a sessionCookie and set listType to followers, then inspect the dataset to ensure the returned accounts match the target profile rather than a generic regional list.
  4. Toggle includeStats to confirm that followerCount, followingCount, heartCount, and videoCount fields are populated in the output items.
  5. Add multiple entries to usernames or profileUrls when scaling up your collection across several target creators.
  6. Increase maxUsersPerProfile up to 5000 to pull deeper follower or following lists once basic connectivity is verified.

How do you apply it? Three worked playbooks

These are TikTok Followers & Following Scraper's own documented use cases, each worked through as an operating pattern rather than a description.

Use case 1: Influencer scouting

Outcome: Discover which accounts top creators follow to find emerging talent before they go viral

Configure: Set listType to following and input usernames for top creators with maxUsersPerProfile set to 100.

Working method: Start with a single creator handle and extract their following list. Review the output for niche overlap and recurring accounts. Expand to a small cohort of creators to cross-reference their connections.

Deliverable: A structured dataset of user profiles showing who target creators follow, complete with engagement stats.

Stop condition: The returned following list contains irrelevant handles or lacks expected profile metadata.

Use case 2: Audience research

Outcome: Export a brand account's follower list for CRM enrichment or lookalike audience building

Configure: Set listType to followers, provide the brand profile URL, and supply a sessionCookie alongside includeStats set to true.

Working method: Run the Actor against a major brand profile to capture its follower base. Inspect followerCount and bio fields to segment the audience before exporting for enrichment.

Deliverable: A CSV file containing the brand's followers with profile details and engagement metrics.

Stop condition: The output contains generic regional users instead of the brand's true followers due to an invalid session cookie.

Use case 3: Competitive analysis

Outcome: Identify follower overlap between competing accounts or creators in the same niche

Configure: Set listType to both, populate usernames with competing accounts, and supply a valid sessionCookie.

Working method: Collect followers and following lists for competing profiles in parallel runs. Cross-reference the resulting datasets to find shared follower IDs and mutual connections.

Deliverable: A comparative dataset highlighting shared user IDs and overlap metrics across competing accounts.

Stop condition: The Actor fails to retrieve complete lists for the specified competitors or returns empty datasets.

What breaks, and how do you design around it?

  • Over the last 30 days, 1.6% of public runs failed and 0.0% timed out. Build retries and alerting around those rates rather than assuming every run completes.

TikTok enforces a pagination cap of 5,000 users per profile, so split targets across multiple runs when harvesting larger accounts. Ensure your sessionCookie remains valid during followers mode to prevent the API from returning generic regional lists.

When should you not use TikTok Followers & Following Scraper?

Do not use this Actor if your objective is to collect individual video content, comments, or keyword-based video feeds rather than user profiles. If you need to search for videos by keywords, TikTok Search Scraper is the better choice. If you want to collect videos that mention specific handles, use TikTok Mention Scraper or TikTok Profile Mention Scraper. For analyzing specific sounds, use TikTok Music/Sound Scraper. Trying to adapt this profile-focused scraper for video metrics will yield incomplete results and waste compute resources.

What should you check before trusting the output?

  • Check that the listType field matches the requested mode and is not returning generic regional output when harvesting followers.
  • Verify that the username and userId fields are present and non-empty for every record in the dataset.
  • Alert if followerCount or videoCount fail to populate when includeStats is enabled.
  • Confirm that the scrapedAt timestamp is present and reflects the expected collection time for the run.
  • Stop scheduled runs if consecutive outputs return zero records for valid usernames or profile URLs.

None of this proves a record is correct. It gives a scheduled TikTok Followers & Following Scraper run defined points where it should stop instead of quietly passing bad data downstream.

Frequently asked questions

How much does it cost to run?

Results cost $5.00 per 1,000 results on the free tier, which breaks down to $0.005 per result written to the dataset. Run-start fees and platform usage are billed separately by Apify on top of these result charges.

Do I need a session cookie for both modes?

No, a session cookie is only required when scraping the followers list. The following list mode operates without authentication because TikTok's following endpoint is publicly accessible.

How do I obtain a session cookie?

Install a cookie editor browser extension while logged into TikTok, locate the sessionid cookie value, and copy it directly into the sessionCookie input field of the Actor.

What is the maximum number of users per profile?

The practical limit enforced by TikTok pagination is 5,000 users per profile. You can configure maxUsersPerProfile up to this threshold to pull deep follower or following lists.

Can I scrape multiple profiles in a single execution?

Yes, you can input multiple entries into the usernames or profileUrls arrays. The Actor will process each specified profile sequentially during the run.

Where to go next

When you are ready to run it, open TikTok Followers & Following Scraper on Apify; the free plan covers up to 1,000 results a month.

Start with the TikTok Followers & Following Scraper Actor page for the current input schema, pricing tier, and run history.

It is part of the TikTok Scraping Suite, which puts every related Actor on one page with its price and run history.

Readers running TikTok Followers & Following Scraper commonly pair it with:

Related guides:

Resources

  • Actor documentation, input schema, and pricing: verified against the published Actor on 2026-09-24.

  • Actor last updated by its maintainers on 2026-06-30.

  • Run outcome figures cover the 30 day public window ending 2026-09-24.

  • TikTok Followers & Following Scraper on Apify

● Featured actors

TikTok Followers & Following Scraper

Scrape the followers and following lists for TikTok profiles. Input usernames or profile URLs. Supports pagination up to thousands of users. No cookies required.

Run on Apify ↗