Twitter/X Followers Scraper

What You Can Scrape

• Followers: Everyone who follows the target user.
• Following: Accounts the user follows.
• Verified followers: All verified followers of a specific User
• Rich profile metadata for every retrieved user (ID, username, name, bio, stats, creation date, …)

Why Scrape Followers/Following

With 400 M+ active users, Twitter/X is a goldmine for social-graph intelligence. Teams use this actor to:

• Discover influencers & outreach targets within a niche
• Map competitor audiences and refine ad-targeting or content strategy
• Generate lead lists from followers that match specific intent signals
• Build research datasets for academic or sentiment analysis

Output Data Fields

Each exported user contains the following 18 fields:

Field	Type	Description
🆔 ID	string	Twitter user unique identifier
👤 Handle	string	Twitter user handle (e.g., "elonmusk")
📛 Name	string	Display name of the user
📝 Bio	string	User biography/description
💬 CanDM	boolean	Whether the user can receive direct messages
📅 AccountCreateDate	string	Account creation date in ISO format
📍 Location	string	User location as specified in profile
👥 FollowersCount	number	Number of followers
🔗 FollowingCount	number	Number of accounts following
❤️ TotalFavouritesByUser	number	Total number of likes given by user
🖼️ MediaCount	number	Number of media files posted
🌐 UserPageURL	string	Direct URL to user profile page
🖼️ ProfileBannerURL	string	URL to profile banner image
📷 ProfileURL	string	URL to profile image
🎭 AvatarURL	string	URL to user avatar image
📊 PostCount	number	Total number of posts/tweets
✅ Verified	boolean	Legacy verification status
🔵 IsBlueVerified	boolean	Twitter Blue verification status

Example output (JSON)

{
    "TaskId": "20250907104346422435",
    "ID": "2285608116",
    "Handle": "TheMarriageFdn",
    "Name": "The Marriage Foundation",
    "Bio": "A one-time divorce mediator I became a marriage healer in 2003 and founded the nonprofit in 2009. We helped thousands achieve a permanently happy marriage.",
    "CanDM": true,
    "AccountCreateDate": "1/11/2014, 4:34:22 AM",
    "Location": "San Diego, CA",
    "FollowersCount": 794,
    "FollowingCount": 1938,
    "TotalFavouritesByUser": 403,
    "MediaCount": 325,
    "UserPageURL": "https://x.com/TheMarriageFdn",
    "ProfileBannerURL": "https://pbs.twimg.com/profile_banners/2285608116/1677992995",
    "ProfileURL": "https://t.co/NIYKSSM9Cx",
    "AvatarURL": "https://pbs.twimg.com/profile_images/1632246989739159554/exnm2NBP_normal.png",
    "PostCount": 794,
    "Verified": false,
    "IsBlueVerified": false
}

Getting Started

1.Getting Twitter/X Cookies

Install the Cookie Editor Chrome extension.

Log in to your Twitter/X account in the same browser window.

Click the Cookie-Editor icon in the toolbar.

In the popup, click Export button (at bottom-right corner).

Choose “Header String”.

Paste that string into the cookie field of this actor’s input (or pass it in your API call).

🛡️ note:Your cookie is stored as a secret input on Apify—automatically encrypted and never exposed in logs, so it remains completely secure.

2. Configure Your Actor Run

Now you're ready to configure the actor. Here's how to set up your input parameters:

Field	Type	Required	Description
handle	string	✅	Twitter user handle (e.g., @elonmusk)
exportType	string	✅	Type of data to export: "followers", "followings", or "verified_followers"
cookie	string	✅	Complete Twitter cookie string for authentication
maxResults	number	❌	Maximum number of users to export (default: 1000, you can set a large number for extensive scraping)
delay	number	❌	Delay between requests in seconds (default: 10, recommended: 10s)
proxyConfiguration	object	❌	Optional proxy settings. Leave empty for default behavior, configure only if needed for special cases

3. Run it through APIFY Console or API

3.1 Run in Apify Console (very easy to use)

• Open Apify Console, go to this Actor page, and click “Run” (or create a Task first and run it).
• In the Input panel, fill in:
  • handle: Target username (without @), e.g., elonmusk.
  • exportType: Select from the dropdown: Followers / Following / Verified Followers.
  • cookie: Paste the cookie obtained with the Cookie Editor extension described above.
  • maxResults: Number of users to export for this run, e.g., 10000.
  • delay: Request interval in seconds; recommended 10–20 (default 10).
  • proxyConfiguration: Usually not required; leave empty unless you have special needs.
• Click “Run”.

During the run and reviewing results:

• Dataset tab: View/download results as JSON/CSV/NDJSON.
• Logs: Check logs

3.2 Run via API

• handle: Target username (without @), e.g., elonmusk.
• exportType must be one of: "followers", "following", "verified_followers".
• cookie: Paste the cookie obtained with the Cookie Editor extension described above.

JavaScript:

import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    handle: 'elonmusk',
    exportType: 'Followers',
    cookie: 'auth_token=...; ct0=...; ...',
    maxResults: 1000,
};

// Run the Actor and wait for it to finish
const run = await client.actor('xtcodetech/twitter-x-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);
});

Python:

from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "handle": "elonmusk",
    "exportType": "Followers",
    "cookie": "auth_token=...; ct0=...; ...",
    "maxResults": 1000,
}

# Run the Actor and wait for it to finish
run = client.actor("xtcodetech/twitter-x-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)