# TikTok Followers Scraper (`clockworks/tiktok-followers-scraper`) Actor Scrape TikTok followers and following profiles from any account. Input a profile name, and get detailed lists of followers and following profiles with complete metadata. Perfect for lead generation, audience analysis, and segmentation. - **URL**: https://apify.com/clockworks/tiktok-followers-scraper.md - **Developed by:** [Clockworks](https://apify.com/clockworks) (Apify) - **Categories:** Social media, Videos, Lead generation - **Stats:** 5,887 total users, 285 monthly users, 99.7% runs succeeded, 28 bookmarks - **User rating**: 4.32 out of 5 stars ## Pricing from $1.00 / 1,000 follower / followings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What can TikTok Followers Scraper do? TikTok Followers Scraper is a simple Actor with which you can download TikTok following list in seconds. You’ll get full metadata information about who is following or which accounts are followed by any given TikTok account. - See the **profiles of everybody following a TikTok account** - Get an overview of all the **profiles followed by any TikTok user** - Scraped profiles **include metadata** - **Get up to 10,000 followers and following profiles**, or narrow it down to just a few - Scrape up to 1,000 followers for free - Export data in multiple formats: **JSON, CSV, Excel, or HTML** - Export via SDKs (Python & Node.js), use **API Endpoints**, **webhooks**, or integrate with workflows ### What data can I extract with TikTok Followers Scraper?
🔗 Connection type 🆔 Connection ID 🏷️ Connection name 🌐 Connection profile URL
🐱 Connection nickname ✍️ Connection signature 📄 Connection bio link 🖼️ Connection avatar URL
👥 Connection’s number of fans 🎥 Connection’s number of videos ❤️ Connection’s number of likes 🤝 Connection’s number of friends
### How to use TikTok Followers Scraper TikTok Followers Scraper is designed with users in mind, even those who have never extracted data from the web before. Using it takes just a few steps. 1. [Create](https://console.apify.com/actors/i7JuI8WcwN94blNMb?addFromActorId=i7JuI8WcwN94blNMb) a free Apify account using your email 2. Open [TikTok Followers Scraper](https://apify.com/clockworks/tiktok-followers-scraper) 3. Add one or more TikTok usernames 4. Click the “Start” button and wait for the data to be extracted 5. Download the TikTok following list in JSON, XML, CSV, Excel, or HTML ### ⬆️ Input To use TikTok Followers Scraper, all you need to do is enter the username of the account you want to scrape, and set the maximum number of followers and following profiles you want. TikTok Followers Scraper input Here’s what the input looks like in the JSON field. ```json { "maxFollowersPerProfile": 50, "maxFollowingPerProfile": 50, "profiles": ["khaby.lame"] } ```` ### ⬇️ Output and TikTok followers export The results will be wrapped into a dataset which you can find in the **Storage** tab. Here's an excerpt from the dataset you'd get if you apply the input parameters above: TikTok Followers Scraper output You can also view the output in JSON in the Console, or download the TikTok following list in JSON, Excel, XML, or CSV. ```json [ { "authorMeta": { "id": "7311784520335672326", "name": "mygod.did", "profileUrl": "https://www.tiktok.com/@mygod.did", "nickName": "mygod.did", "verified": false, "signature": "", "bioLink": null, "originalAvatarUrl": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c439fb6db70673a45fbb70432dfcf415~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=6ae7dba9&x-expires=1757833200&x-signature=woiiDihcGrwhWarwv9H1dMPICGQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a", "avatar": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c439fb6db70673a45fbb70432dfcf415~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=6ae7dba9&x-expires=1757833200&x-signature=woiiDihcGrwhWarwv9H1dMPICGQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a", "privateAccount": true, "ttSeller": false, "following": 714, "friends": 0, "fans": 1000, "heart": 1966, "video": 2, "digg": 64800 }, "connectedTo": { "id": "127905465618821121", "name": "khaby.lame", "profileUrl": "https://www.tiktok.com/@khaby.lame", "nickName": "Khabane lame", "verified": true, "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "bioLink": "https://bit.ly/3Zn5cDf", "originalAvatarUrl": "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/e755d298d36b3175a2ca87d603b5dc2d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=9cc7aa90&x-expires=1757833200&x-signature=YdjHgLPFFF3vljDdRKiQKXJMieI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a", "avatar": "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/e755d298d36b3175a2ca87d603b5dc2d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=9cc7aa90&x-expires=1757833200&x-signature=YdjHgLPFFF3vljDdRKiQKXJMieI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a", "commerceUserInfo": { "commerceUser": false }, "privateAccount": false, "roomId": "", "ttSeller": false, "following": 83, "friends": 74, "fans": 161400000, "heart": 2500000000, "video": 1289, "digg": 0 }, "connectionType": "follower", "connectionDescription": "mygod.did is a follower of khaby.lame" } ] ``` ### How can I use the data extracted from TikTok with TikTok Followers Scraper? You can use the data scraped with TikTok Followers Scraper for the following: - **Map out which accounts are following** a user and adjust your content accordingly - See which accounts **are followed by any other account** and detect patterns - Figure out which **other accounts are followed** by your followers - Create a pipeline full of [**perfect-fit marketing leads**](https://blog.apify.com/marketing-leads-scraping-with-apify/) - **Monitor your competitors’ followers** to use for segmentation and remarketing - Use followers’ list for s**ocial media listening** and **fake news research** - Check if your **influencers’ followers** are in line with your **target group** ### Scrape any TikTok data you need with dedicated scrapers If you need other TikTok data, check out any of our other specialized TikTok scrapers.
🎹 Tiktok Scraper 📹 Tiktok Video Scraper 🧛 TikTok Profile Scraper 🎸 Tiktok Sound Scraper
#️⃣ TikTok Hashtag Scraper 📈Tiktok Trends Scraper 💬 TikTok Comments Scraper 🔍TikTok Discover Scraper
👥 TikTok User Search Scraper 🏝️ TikTok Explore Scraper
Also, check out our agents that can both scrape TikTok and perform other actions: - [Comments Analyzer Agent](https://apify.com/apify/comments-analyzer-agent) - [Influencer Discovery Agent](https://apify.com/apify/influencer-discovery-agent) - [Local Lead Generation Agent](https://apify.com/apify/local-lead-generation-agent) ### Frequently asked questions #### How much will using TikTok Followers Scraper cost you? TikTok Followers Scraper uses our pay-per-event (PPE) model, meaning that you pay a fixed price for each specific event the Actor performs. For more details and prices, check out the Actor’s [pricing tab](https://apify.com/clockworks/tiktok-followers-scraper/pricing). For example, if you’re on the Free plan, your $5 worth of credit will get you over 1,000 results, while paid users are able to get a discount (read about how this works on the [Apify pricing page](https://apify.com/pricing)). #### Can I use integrations with TikTok Followers Scraper? You can integrate TikTok Followers Scraper with almost any cloud service or web app. We offer integrations with [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [n8n](https://docs.apify.com/platform/integrations/n8n), GitHub, Google Sheets, Google Drive, [and plenty more](https://docs.apify.com/integrations). Alternatively, you could use [webhooks](https://docs.apify.com/integrations/webhooks) to carry out an action whenever an event occurs, such as getting a notification whenever TikTok Followers Scraper successfully finishes a run. #### Can I use TikTok Followers Scraper with the Apify API? The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify Actors. The API also lets you access any datasets, monitor Actor performance, fetch results, create and update versions, and more. To access the API using Node.js, use the `apify-client` [NPM package](https://apify.com/clockworks/tiktok-followers-scraper/api/javascript). To access the API using Python, use the `apify-client` [PyPI package](https://apify.com/clockworks/tiktok-followers-scraper/api/python). Check out the [Apify API reference](https://docs.apify.com/api/v2) docs for all the details. #### Can I use TikTok Followers Scraper through an MCP Server? With Apify API, you can use almost any Actor in conjunction with an MCP server. You can connect to the MCP server using clients like ClaudeDesktop and LibreChat, or even build your own. Read all about how you can [set up Apify Actors with MCP](https://blog.apify.com/how-to-use-mcp/). For TikTok Followers Scraper, go to the [MCP tab](https://apify.com/clockworks/tiktok-followers-scraper/api/mcp) and then go through the following steps: 1. Start a Server-Sent Events (SSE) session to receive a `sessionId` 2. Send API messages using that `sessionId` to trigger the scraper 3. The message starts the TikTok Followers Scraper with the provided input 4. The response should be: `Accepted` #### Is it legal to scrape TikTok followers and following profiles list? TikTok Followers Scraper does not extract any private user data, such as email addresses, gender, or location. It only extracts data that a user has chosen to share publicly. If you're unsure about any more specific questions regarding scraping and privacy, consult your lawyers. We also have a blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). #### Your feedback We’re always working on improving the performance of our Actors. If you have any technical feedback for TikTok Followers Scraper or found a bug, please create an issue in the [Issues tab](https://apify.com/clockworks/tiktok-followers-scraper/issues/open). ### Error items When the scraper cannot retrieve data for a given input — for example a profile is private or a post has been deleted — it pushes an **error item** to the dataset instead of silently skipping it. Normal output items are never affected; you can tell them apart by the presence of an `errorCode` field. #### Error item structure ```json { "url": "https://www.tiktok.com/@someuser", "input": "someuser", "error": "Profile is private", "errorCode": "PROFILE_PRIVATE" } ``` #### Error codes reference | `errorCode` | Meaning | | -------------------------------- | -------------------------------------------------------------- | | `NOT_FOUND` | Profile or hashtag does not exist | | `POST_NOT_FOUND_OR_PRIVATE` | Post URL is gone or private | | `POST_SENSITIVE` | Post is flagged as sensitive content | | `NO_TRENDING_FOR_HASHTAG` | No ads found for this hashtag | | `MUSIC_NOT_FOUND` | No videos found for the music tag | | `SEARCH_QUERY_NOT_FOUND` | No videos found for the search query | | `SEARCH_QUERY_PROFILE_NOT_FOUND` | No profiles found for the search query | | `FILTER_NO_PASS` | Videos exist but none match the active date/popularity filters | | `PROFILE_EMPTY` | Profile has no videos (or is behind a login wall) | | `PROFILE_REPOSTS_EMPTY` | Profile has no reposts (or is behind a login wall) | | `PROFILE_FOLLOWING_EMPTY` | Profile is not following anyone | | `PROFILE_FOLLOWERS_EMPTY` | Profile has no followers | | `PROFILE_PRIVATE` | Profile is private | | `GOOGLE_RUN_NO_RESULTS` | Google-assisted run returned no results | | `TRENDING_EMPTY` | Trending page returned no results | | `INVALID_INPUT` | Actor failed due to bad configuration (run is also terminated) | | `INVALID_URLS` | One or more start URLs were malformed | # Actor input Schema ## `profiles` (type: `array`): Add one or multiple TikTok usernames, whose followers and following profiles' list you want to get. ## `maxFollowersPerProfile` (type: `integer`): Maximum number of followers you want to scrape per profile. ## `maxFollowingPerProfile` (type: `integer`): Maximum number of following profiles you want to scrape per profile. ## Actor input object example ```json { "profiles": [ "khaby.lame" ], "maxFollowersPerProfile": 50, "maxFollowingPerProfile": 50 } ``` # Actor output Schema ## `dataset` (type: `string`): Dataset containing all scraped data # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "profiles": [ "khaby.lame" ], "maxFollowersPerProfile": 50, "maxFollowingPerProfile": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("clockworks/tiktok-followers-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "profiles": ["khaby.lame"], "maxFollowersPerProfile": 50, "maxFollowingPerProfile": 50, } # Run the Actor and wait for it to finish run = client.actor("clockworks/tiktok-followers-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "profiles": [ "khaby.lame" ], "maxFollowersPerProfile": 50, "maxFollowingPerProfile": 50 }' | apify call clockworks/tiktok-followers-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=clockworks/tiktok-followers-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Followers Scraper", "description": "Scrape TikTok followers and following profiles from any account. Input a profile name, and get detailed lists of followers and following profiles with complete metadata. Perfect for lead generation, audience analysis, and segmentation.", "version": "0.0", "x-build-id": "TN464NOgOuhEUmz7z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clockworks~tiktok-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clockworks-tiktok-followers-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/clockworks~tiktok-followers-scraper/runs": { "post": { "operationId": "runs-sync-clockworks-tiktok-followers-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/clockworks~tiktok-followers-scraper/run-sync": { "post": { "operationId": "run-sync-clockworks-tiktok-followers-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "profiles", "maxFollowersPerProfile", "maxFollowingPerProfile" ], "properties": { "profiles": { "title": "🎯 Usernames", "type": "array", "description": "Add one or multiple TikTok usernames, whose followers and following profiles' list you want to get.", "items": { "type": "string" } }, "maxFollowersPerProfile": { "title": "🗂️ Maximum number of followers profiles", "minimum": 0, "type": "integer", "description": "Maximum number of followers you want to scrape per profile." }, "maxFollowingPerProfile": { "title": "🗂️ Maximum number of following profiles", "minimum": 0, "type": "integer", "description": "Maximum number of following profiles you want to scrape per profile." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```