# X Twitter Followers and Followings Scraper (`arjun_code/x-twitter-followers-followings-scraper`) Actor Extract public X followers or following profiles by screen name or user ID. Choose one relationship type, set a result limit, and export raw user records to an Apify Dataset. This unofficial Actor is not affiliated with or endorsed by X. - **URL**: https://apify.com/arjun\_code/x-twitter-followers-followings-scraper.md - **Developed by:** [Arjun AI](https://apify.com/arjun_code) (community) - **Categories:** Social media, Agents, SEO tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.15 / 1,000 record scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## X Twitter Followers and Followings Scraper Retrieve either followers or followings for one or more X/Twitter accounts. Provide usernames, numeric user IDs, or both. Each run collects exactly one relationship type: `followers` or `followings`. ### What this Actor returns The Actor writes one Dataset item for each related account. If one X API page returns 200 users, the Actor stores up to 200 Dataset items. Each Dataset item includes source-account metadata plus the raw X API `user` object: ```json { "source_user_id": "44196397", "source_screen_name": "elonmusk", "requested_identifier": "elonmusk", "relationship_type": "followers", "user": { "id_str": "1278722158970068993", "screen_name": "example", "name": "Example User" } } ```` The `user` object is not simplified or remapped. It is stored as returned by the X followers/followings endpoint. ### Input - `screenNames`: X/Twitter usernames without `@`. - `userIds`: numeric X user IDs stored as strings. - `relationshipType`: exactly `followers` or `followings`. - `maxItemsPerUser`: maximum Dataset items for each source account. Use `0` to request all available pages in the current run. At least one value must be provided in `screenNames` or `userIds`. You can provide both; duplicate source accounts are processed once. ### Followers example ```json { "screenNames": ["elonmusk"], "relationshipType": "followers", "maxItemsPerUser": 1000 } ``` ### Followings example ```json { "userIds": ["44196397"], "relationshipType": "followings", "maxItemsPerUser": 10 } ``` ### Pagination and limits Each X API request asks for up to 200 users. The Actor follows cursors automatically and stores results page by page. - `maxItemsPerUser: 10` stores at most 10 users per source account. - `maxItemsPerUser: 0` attempts to fetch every available page in the current run. - Large accounts can hit X rate limits, Actor runtime limits, or higher platform usage costs. - Protected, unavailable, or rate-limited accounts may return partial or no data. Already stored Dataset items are preserved if a later page fails. ### Credentials and privacy X credentials are loaded from private Actor storage and are not part of the public input. Raw `auth_token`, `ct0`, cookies, local credential files, and login files are not written to the Dataset. Use public relationship data lawfully and follow X, Apify, and applicable privacy requirements. # Actor input Schema ## `screenNames` (type: `array`): X/Twitter usernames without @. Provide usernames, user IDs, or both. ## `userIds` (type: `array`): Numeric X/Twitter user IDs. Provide usernames, user IDs, or both. ## `relationshipType` (type: `string`): Choose exactly one relationship type. ## `maxItemsPerUser` (type: `integer`): Maximum results for each source user. Enter 0 to fetch all available results. ## Actor input object example ```json { "screenNames": [ "elonmusk" ], "userIds": [], "relationshipType": "followers", "maxItemsPerUser": 1000 } ``` # Actor output Schema ## `results` (type: `string`): Followers or followings stored in the default dataset. # 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 = { "screenNames": [ "elonmusk" ] }; // Run the Actor and wait for it to finish const run = await client.actor("arjun_code/x-twitter-followers-followings-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 = { "screenNames": ["elonmusk"] } # Run the Actor and wait for it to finish run = client.actor("arjun_code/x-twitter-followers-followings-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 '{ "screenNames": [ "elonmusk" ] }' | apify call arjun_code/x-twitter-followers-followings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=arjun_code/x-twitter-followers-followings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "X Twitter Followers and Followings Scraper", "description": "Extract public X followers or following profiles by screen name or user ID. Choose one relationship type, set a result limit, and export raw user records to an Apify Dataset. This unofficial Actor is not affiliated with or endorsed by X.", "version": "0.1", "x-build-id": "0JWkC5WJM85D7rEcY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arjun_code~x-twitter-followers-followings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arjun_code-x-twitter-followers-followings-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/arjun_code~x-twitter-followers-followings-scraper/runs": { "post": { "operationId": "runs-sync-arjun_code-x-twitter-followers-followings-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/arjun_code~x-twitter-followers-followings-scraper/run-sync": { "post": { "operationId": "run-sync-arjun_code-x-twitter-followers-followings-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": [ "relationshipType", "maxItemsPerUser" ], "properties": { "screenNames": { "title": "User Name List", "type": "array", "description": "X/Twitter usernames without @. Provide usernames, user IDs, or both.", "items": { "type": "string" } }, "userIds": { "title": "User ID List", "type": "array", "description": "Numeric X/Twitter user IDs. Provide usernames, user IDs, or both.", "items": { "type": "string" }, "default": [] }, "relationshipType": { "title": "Data to collect", "enum": [ "followers", "followings" ], "type": "string", "description": "Choose exactly one relationship type.", "default": "followers" }, "maxItemsPerUser": { "title": "Maximum results per user", "minimum": 0, "type": "integer", "description": "Maximum results for each source user. Enter 0 to fetch all available results.", "default": 1000 } } }, "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 } } } } } } } } } } ```