Twitter Followers Scraper — Followers and Following

Export the followers of any public Twitter (X) account, the accounts it follows, or both. Each row is a profile: handle, name, bio, location, follower and post counts, verification and join date. Add as many accounts as you like and cap the total.

Input

Field	Type	Default	What it does
handles	list of text	—	Required. Handles, with or without the @, or profile links, mixed freely.
relation	followers / followings / both	followers	Which list to export for each account. both reads followers first, then the accounts it follows.
maxItems	integer	100	Caps the whole run, across every account and list. 0 means no limit.

{
  "handles": ["NASA"],
  "relation": "followings",
  "maxItems": 100
}

Output

One row per account in the list.

Field	What it holds
id, handle, name, url	Who they are, and their profile link
description, location, website	Bio, location text, profile link
followers_count, following_count, posts_count, media_count, likes_count	The five counters
is_blue_verified, is_verified, verified_type, protected	Verification and privacy flags
created_at	When the account was created, ISO 8601 UTC
input_handle	The account whose list this row came from
relation	followers or followings — which list the row is from

{
  "id": "1498375883328995332",
  "handle": "astro_hathaway",
  "name": "Jack Hathaway",
  "description": "NASA Astronaut, Group 23 🪰 Naval Aviator & Test Pilot",
  "location": "International Space Station",
  "website": "https://t.co/0uQ1hKagtM",
  "avatar_url": "https://pbs.twimg.com/profile_images/1498376410951561226/LHVhOck4_normal.jpg",
  "banner_url": "https://pbs.twimg.com/profile_banners/1498375883328995332/1665759869",
  "followers_count": 3451,
  "following_count": 74,
  "posts_count": 31,
  "media_count": 4,
  "likes_count": 1,
  "is_verified": false,
  "is_blue_verified": null,
  "verified_type": null,
  "protected": false,
  "created_at": "2022-02-28T19:14:03.000Z",
  "pinned_post_ids": null,
  "is_automated": null,
  "url": "https://x.com/astro_hathaway",
  "input_handle": "NASA",
  "relation": "followings"
}

Pricing

You pay for each account saved. A account that is skipped is never charged.

Plan	Per 1,000 accounts
Free	$1.00
Bronze	$0.85
Silver	$0.69
Gold and above	$0.54

Each run also carries a $0.00005 start charge. The Free plan covers the first 50 rows you save with this Actor; after that you need a paid plan.

Work out the cost before you set maxItems to 0 on a big account. A million followers is 1,000 times the per-1,000 price in the table.

Questions

What order do the accounts come in? X decides, and it is neither alphabetical nor by size. Do not build on it — sort the dataset afterwards if you need an order.

Why are pinned_post_ids and is_automated null on these rows? List rows are lighter than a full profile. Those two fields, and sometimes is_blue_verified, come back null here. Run the Twitter Profile Scraper on the handles you care about to fill them in.

Can I get both lists for several accounts in one dataset? Yes. Set relation to both. input_handle says whose list a row belongs to and relation says which list, so one table holds everything.

Is the follower list complete? It is what X lists at the time of the run. A big account keeps changing while you read it, so treat one run as a snapshot, not a census.

Why fewer rows than the account's followers_count? X's counter and X's list do not always agree. The run saves what X lists and ends when X stops returning pages, so expect the two to be close, not equal.

What if the handle does not exist? No rows, no charge, and a line in the log. Other handles in the list still run.

Related Actors

Actor	Use it when
Twitter Profile Scraper	You need full profile records, or the About panel, for these accounts
Twitter Tweets Scraper	You want what the accounts in the list have posted
Twitter Scraper	You want to find accounts by what they tweet

Support

Questions, bugs, or feature requests: contact@toolzerhub.com

Browse the rest: apify.com/toolzerhub