Export visible public X follower and following relationships as clean, analysis-ready profile rows. This Twitter followers scraper helps creator marketers, social-listening teams, researchers, and lead-generation teams compare audiences, monitor growth, and discover public prospects.
What you get
Each dataset row represents one visible relationship between a requested X profile and a follower or account it follows. Use the stable profile IDs and URLs to join exports over time or compare several audiences.
- Export followers, following, or both for each profile.
- Submit X handles or public
x.com/twitter.comprofile URLs. - Keep source-profile provenance on every row.
- Get conservative public-bio email extraction when an address is explicitly present.
- Preserve rows already collected if another requested profile is restricted.
Input recipe
{
"handles": ["NASA"],
"mode": "followers",
"maxItems": 20,
"includeProfileDetails": true
}
Input recipes
Use these low-volume recipes to validate a public target before increasing the limit.
Example inputs
Compare a creator audience
{
"handles": ["NASA", "NatGeo"],
"mode": "followers",
"maxItems": 50
}
Export Twitter following data from a profile URL
{
"profileUrls": ["https://x.com/github"],
"mode": "following",
"maxItems": 100,
"includeProfileDetails": true
}
Input settings
| Input | Purpose |
|---|---|
handles |
One or more X handles, with or without @. |
profileUrls |
One or more public X or Twitter profile URLs. |
mode |
Choose followers, following, or both. |
maxItems |
Maximum visible rows per selected profile and relationship, from 1 to 500. |
includeProfileDetails |
Include visible public biography, counts, and profile metadata. |
failOnBlocked |
Fail the run if a requested relationship is inaccessible; otherwise retain other successful rows. |
Who is it for?
- Audience-overlap analysis: export follower lists for public accounts and compare normalized profile IDs.
- Creator and influencer research: identify public accounts following relevant creators or brands.
- Social listening: collect a repeatable Twitter following scraper export for periodic change analysis.
- Prospect discovery: filter public profile fields such as bio, website, location, and public contact details.
API usage
Node.js:
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/x-followers-scraper').call({
handles: ['NASA'],
mode: 'followers',
maxItems: 20,
});
console.log(run.defaultDatasetId);
Python:
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("fetch_cat/x-followers-scraper").call(run_input={
"handles": ["NASA"], "mode": "followers", "maxItems": 20
})
print(run["defaultDatasetId"])
cURL:
curl -X POST "https://api.apify.com/v2/acts/fetch_cat~x-followers-scraper/runs?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"handles":["NASA"],"mode":"followers","maxItems":20}'
Retrieve the default dataset from the completed run to download JSON, CSV, or Excel output.
MCP and AI agents
Use Apify MCP to run this X follower data API from an AI agent.
claude mcp add --transport http apify "https://mcp.apify.com?tools=fetch_cat/x-followers-scraper"
{ "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=fetch_cat/x-followers-scraper" } } }
Example prompt: "Export up to 20 visible followers for NASA and summarize the public bio and audience fields."
Tips and limits
- Start with a small
maxItemsto validate the target and relationship. - Only data visible through X's public web experience for the configured managed session can be exported.
- Private accounts, DMs, engagement automation, customer-supplied cookies, and paid/private X data are out of scope.
- X may restrict a target or change public visibility. When possible, successful rows for other targets are preserved and the run summary identifies restricted work.
Support
Open an issue on the Actor page with the profile URL, relationship mode, a sanitized run link, and the expected public result. Do not include cookies or other credentials.