# X.com Profiles Scraper (`parseforge/x-com-profiles-scraper`) Actor Extract comprehensive profile data from X.com (Twitter) including follower counts, verification status, bio, join dates, and 40+ data points. Collect usernames, profile images, location, pinned posts, and professional info. Perfect for marketers, researchers, recruiters, and social media analysts. - **URL**: https://apify.com/parseforge/x-com-profiles-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Social media, Lead generation, Developer tools - **Stats:** 33 total users, 12 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿš€ X.com Profiles Scraper > ๐Ÿ•’ **Last updated:** 2026-05-05 ๐Ÿš€ Scrape user profiles from X.com (formerly Twitter) without authentication using GraphQL API This scraper collects detailed profile data from X.com including user information, account statistics, verification status, and metadata. It uses X.com's public GraphQL API with guest token authentication, requiring no login credentials. **Target Audience:** Researchers, marketers, data analysts, social media monitoring, lead generation **Primary Use Cases:** Profile research, influencer discovery, account monitoring, competitive analysis ### โœจ What Does X.com Profiles Scraper Do? This tool collects comprehensive user profile data from X.com, supporting multiple input methods for flexible data collection. It delivers: - Complete user profile information (username, display name, bio, location) - Account statistics (followers, following, total posts, likes, media count) - Verification status (blue verified, organization verified, verification type) - Profile and cover images - Account creation date and professional account information - Pinned tweets and affiliate information - And more (40+ profile fields) **Business Value:** Research influencers, monitor competitors, build prospect lists, analyze account metrics, and track profile changes without manual data collection. ### ๐Ÿ”ง Input To start scraping X.com profiles, configure the input form. You can scrape profiles based on: - **startUrls** - Direct URLs to X.com profiles or tweets (e.g., `https://x.com/username` or `https://x.com/username/status/1234567890`) - **twitterHandles** - List of X.com usernames (without @) to scrape - **twitterUserIds** - List of X.com user IDs to scrape profiles from - **maxItems** - Maximum number of profiles to collect (Free users: Limited to 10. Paid users: Optional, max 1,000,000) - **filterByBlueVerified** - `true` = only blue verified accounts, `false` = only non-verified, empty = all - **filterByProfessionalType** - Filter by account type: `Creator` or `Business`. Leave empty for all. **Note:** When providing a tweet URL, the scraper will extract the tweet author's profile. Here's what the input configuration looks like in JSON: ```json { "twitterHandles": ["elonmusk", "apify"], "maxItems": 10 } ```` Or using direct URLs: ```json { "startUrls": [ { "url": "https://x.com/elonmusk" }, { "url": "https://x.com/apify/status/1234567890" } ], "maxItems": 50 } ``` ### ๐Ÿ“Š Output After the Actor finishes its run, you'll get a dataset with the output. The length of the dataset depends on the amount of results you've set. You can download those results as an Excel, HTML, XML, JSON, and CSV document. Here's an example of scraped X.com profile data with all available fields: ```json { "type": "user", "imageUrl": "https://pbs.twimg.com/profile_images/2008546467615580160/57KcqsTA_400x400.jpg", "id": "44196397", "userName": "elonmusk", "url": "https://x.com/elonmusk", "twitterUrl": "https://twitter.com/elonmusk", "name": "Elon Musk", "isVerified": false, "isBlueVerified": true, "verifiedType": "This account is verified because it's an affiliate of @X on X. Learn more", "profilePicture": "https://pbs.twimg.com/profile_images/2008546467615580160/57KcqsTA_400x400.jpg", "coverPicture": "https://pbs.twimg.com/profile_banners/44196397/1739948056", "description": "", "location": "", "followers": 235907652, "following": 1291, "protected": false, "status": "", "canDm": false, "canMediaTag": false, "createdAt": "Tue Jun 02 20:12:29 +0000 2009", "entities": { "description": { "urls": [] } }, "fastFollowersCount": 0, "favouritesCount": 214257, "listedCount": 167728, "hasCustomTimelines": true, "isTranslator": false, "mediaCount": 4372, "statusesCount": 98350, "withheldInCountries": [], "affiliatesHighlightedLabel": { "label": { "badge": { "url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg" }, "description": "X", "url": { "url": "https://twitter.com/X", "urlType": "DeepLink" }, "userLabelDisplayType": "Badge", "userLabelType": "BusinessLabel" } }, "pinnedTweetIds": [ "2028500984977330453" ], "professional": { "category": [], "professional_type": "Creator", "rest_id": "1679729435447275522" }, "websiteUrl": null, "profileImageShape": "Circle", "creatorSubscriptionsCount": 238, "businessAffiliatesCount": null, "followerOf": null, "followingOf": null, "retweeterOf": null, "tweetId": null, "source": "profile", "isUnavailable": false, "unavailableReason": null, "scrapedTimestamp": "2026-03-04T22:07:46.483Z" } ``` **What You Get:** Complete profile data including: **Account Information:** - Username, display name, and user ID - Profile and cover pictures - Biography/description and location - Account creation date - URLs (X.com and Twitter.com format) - Website URL (from bio link, expanded) - Profile image shape (`Circle` = NFT avatar, `Square` = standard) **Verification & Status:** - Verification status (blue verified, organization verified) - Verification type description - Account protection status - Professional account information (type: Creator or Business) - Affiliate highlighted labels - Creator subscriptions count - Business affiliates count **Statistics:** - Followers and following counts - Total posts/statuses count - Favorites/likes count - Media count and listed count - Fast followers count (if applicable) **Additional Metadata:** - Pinned tweet IDs - Custom timelines availability - Translator status - Withheld countries (if any) - DM and media tag permissions - Account entities (URLs in bio, etc.) **System Data:** - Scraped timestamp for tracking when data was collected **Download Options:** CSV, Excel, or JSON formats for easy analysis ### ๐ŸŽฏ Why Choose the X.com Profiles Scraper? - **No Authentication Required**: Uses guest token - no login credentials needed - **Fast and Efficient**: Direct GraphQL API access for quick profile collection - **Comprehensive Data**: Captures 40+ profile fields including verification, stats, and metadata - **Flexible Input**: Support for handles, user IDs, profile URLs, and tweet URLs - **Reliable**: Handles rate limiting and errors gracefully **Time Savings:** Automate profile collection that would take hours manually **Efficiency:** Collect thousands of profiles in minutes instead of days ### ๐Ÿ“‹ How to Use 1. **Sign Up**: [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes) 2. **Find the Scraper**: Visit the X.com Profiles Scraper page 3. **Set Input**: Add your handles, user IDs, or URLs (we'll show you exactly what to enter) 4. **Run It**: Click "Start" and let it collect your data 5. **Download Data**: Get your results in the "Dataset" tab as CSV, Excel, or JSON **Total Time:** Less than 5 minutes from signup to results **No Technical Skills Required:** Everything is point-and-click ### ๐ŸŽฏ Business Use Cases **Lead Generation:** - Build prospect lists from X.com profiles - Identify influencers in your niche - Research potential customers **Competitive Analysis:** - Monitor competitor accounts - Track follower growth over time - Analyze profile changes **Market Research:** - Collect industry expert profiles - Analyze verification patterns - Track professional accounts **Social Media Management:** - Monitor client profiles - Track account statistics - Build comprehensive profile databases *** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐ŸŽฏ | **Built for the job.** Scoped specifically to this data source so you skip the parser engineering entirely. | | ๐Ÿ”– | **Structured output.** Clean, typed fields ready for analysis, dashboards, or downstream pipelines. | | โšก | **Fast.** Optimized request patterns return results in seconds, not minutes. | | ๐Ÿ” | **Always fresh.** Every run pulls live data, so the dataset reflects the source as of run time. | | ๐ŸŒ | **No infra to manage.** Apify handles proxies, retries, scaling, scheduling, and storage. | | ๐Ÿ›ก๏ธ | **Reliable.** Battle-tested across many runs and edge cases, with graceful error handling. | | ๐Ÿšซ | **No code required.** Configure in the UI, run from CLI, schedule via cron, or call from any language with the Apify SDK. | > ๐Ÿ“Š Production-grade structured data without the engineering overhead of building and maintaining your own scraper. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ X.com Profiles Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Full source coverage | **Live per run** | Source-native filters supported | โšก 2 min | | Build your own scraper | Engineering hours | Full once built | Whenever you maintain it | Custom code | ๐Ÿข Days to weeks | | Paid managed APIs | $$$ monthly | Vendor-defined | Live | Vendor-defined | โณ Hours | | Third-party data dumps | Varies | Subset, often stale | Periodic | None | ๐Ÿ•’ Variable | Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the X.com Profiles Scraper page on the Apify Store. 3. ๐ŸŽฏ **Set input.** Configure the input fields in the form (or paste a JSON), then set `maxItems`. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor collect your data. 5. ๐Ÿ“ฅ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿ“Š Data & Analytics - Build trend reports and dashboards from live source data - Feed BI tools, warehouses, and ML pipelines with structured records - Run periodic snapshots to track changes over time - Compare segments, regions, or categories with consistent fields #### ๐Ÿข Operations & Strategy - Monitor competitor moves, pricing, and inventory shifts - Build internal directories and lookup tools backed by current data - Power workflows that depend on fresh source records - Cut manual data-gathering time from hours to minutes
#### ๐ŸŽฏ Marketing & Growth - Identify market opportunities and trending topics - Research target audiences and customer personas at scale - Power lead-generation pipelines with verified records - Track sentiment, reviews, or social signals over time #### ๐Ÿ› ๏ธ Engineering & Product - Prototype features that need real-world data without owning a crawler - Replace fragile in-house scrapers with a managed Actor - Wire datasets into your apps via the Apify API or webhooks - Skip the proxy, retry, and parsing maintenance entirely
*** ### ๐ŸŒŸ Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### ๐ŸŽจ Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### ๐Ÿค Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### ๐Ÿงช Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
### ๐Ÿ”Œ Using X.com Profiles Scraper with the Apify API For advanced users who want to automate this process, you can control the scraper programmatically with the Apify API. This allows you to schedule regular data collection and integrate with your existing business tools. - **Node.js**: Install the apify-client NPM package - **Python**: Use the apify-client PyPI package - See the [Apify API reference](https://docs.apify.com/api/v2) for full details ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20X.COM%20PROFILES%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20X.COM%20PROFILES%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20X.COM%20PROFILES%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20X.COM%20PROFILES%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### โ“ Frequently Asked Questions **Q: How does it work?** A: X.com Profiles Scraper uses X.com's public GraphQL API with guest token authentication. No login credentials are required. **Q: How many profiles can I scrape?** A: Free users are limited to 10 profiles per run. Paid users can scrape up to 1,000,000 profiles per run. **Q: Can I scrape followers or following lists?** A: No, X.com's API requires authentication to access followers/following lists. This scraper only collects individual profile data. **Q: How accurate is the data?** A: Data is collected directly from X.com's API, ensuring accuracy and completeness. **Q: Can I schedule regular runs?** A: Yes, you can schedule runs using Apify's scheduling feature or the API. **Q: What if I need help?** A: Contact support through the Apify platform for assistance. **Q: Is my data secure?** A: Yes, all data is processed securely and stored in your private Apify account. ### ๐Ÿ”Œ Integrations Connect this actor with your favorite tools: - [Make](https://docs.apify.com/platform/integrations/make) - Automate workflows - [Zapier](https://docs.apify.com/platform/integrations/zapier) - Connect 5000+ apps - [Slack](https://docs.apify.com/platform/integrations/slack) - Get notifications - [Airbyte](https://docs.apify.com/platform/integrations/airbyte) - Data pipelines - [GitHub](https://docs.apify.com/platform/integrations/github) - CI/CD integration - [Google Drive](https://docs.apify.com/platform/integrations/drive) - Export to sheets ### ๐Ÿ”Œ Integrate with any app X.com Profiles Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe results into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. Push fresh data into your product backend, or alert your team in Slack. *** ### ๐Ÿ”— Recommended Actors Looking for more data collection tools? Check out these related actors: | Actor | Description | Link | |-------|-------------|------| | PR Newswire Scraper | Extract press releases and news articles from PR Newswire for media monitoring and competitive intelligence | | | Hubspot Marketplace Scraper | Collect business app data from HubSpot marketplace for market research and competitive analysis | | | Pitchbook Investors Scraper | Extract investor data from PitchBook for fundraising and market intelligence | | | Auto Video Thumbnail Generator | Generate professional video thumbnails using AI for social media content creation | | | Smart Apify Actor Scraper | Extract comprehensive data from Apify actors including quality metrics and field information | | **Pro Tip:** ๐Ÿ’ก Browse our complete collection of [data collection actors](https://apify.com/parseforge) to find the perfect tool for your business needs. *** *Contact us* to request a new scraper, propose a custom data project, or report a technical issue with this actor at https://tally.so/r/BzdKgA > **โš ๏ธ Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by X.com (Twitter) or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. # Actor input Schema ## `startUrls` (type: `array`): Direct X.com URLs to scrape. Supports profile URLs and tweet URLs. Use this OR the filters below, not both. ## `maxItems` (type: `integer`): Maximum number of profiles to collect (Free users: Limited to 10. Paid users: Optional, max 1,000,000). Leave empty for unlimited. ## `twitterHandles` (type: `array`): List of X.com handles (without @). Use this OR startUrls, not both. ## `twitterUserIds` (type: `array`): List of X.com user IDs to scrape profiles from. Can be used together with twitterHandles. ## `filterByBlueVerified` (type: `boolean`): If true, return only X Premium (blue verified) accounts. If false, return only non-blue-verified accounts. Leave empty for all. ## `filterByProfessionalType` (type: `string`): Return only accounts of a specific professional type. Options: Creator, Business. Leave empty for all. ## `proxyConfiguration` (type: `object`): Configure Apify proxy for requests. ## Actor input object example ```json { "maxItems": 10, "twitterHandles": [ "elonmusk", "sama", "naval", "paulg", "garrytan", "vitalikbuterin", "jack", "barackobama", "billgates", "justinbieber", "taylorswift13", "rihanna", "selenagomez", "cristiano", "narendramodi", "potus", "cnn", "bbcworld", "nytimes", "reuters", "bloomberg", "nasa", "spacex", "tesla", "apple", "google", "microsoft", "amazon", "netflix", "openai", "ylecun", "karpathy", "sundarpichai", "tim_cook", "satyanadella", "jeffbezos", "shakira", "kimkardashian", "arianagrande", "drake", "beyonce", "katyperry", "arishlp", "jeffdean", "demishassabis", "ilyasut", "andrewyng", "pmarca", "balajis", "palmerluckey" ] } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "maxItems": 10, "twitterHandles": [ "elonmusk", "sama", "naval", "paulg", "garrytan", "vitalikbuterin", "jack", "barackobama", "billgates", "justinbieber", "taylorswift13", "rihanna", "selenagomez", "cristiano", "narendramodi", "potus", "cnn", "bbcworld", "nytimes", "reuters", "bloomberg", "nasa", "spacex", "tesla", "apple", "google", "microsoft", "amazon", "netflix", "openai", "ylecun", "karpathy", "sundarpichai", "tim_cook", "satyanadella", "jeffbezos", "shakira", "kimkardashian", "arianagrande", "drake", "beyonce", "katyperry", "arishlp", "jeffdean", "demishassabis", "ilyasut", "andrewyng", "pmarca", "balajis", "palmerluckey" ] }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/x-com-profiles-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 = { "maxItems": 10, "twitterHandles": [ "elonmusk", "sama", "naval", "paulg", "garrytan", "vitalikbuterin", "jack", "barackobama", "billgates", "justinbieber", "taylorswift13", "rihanna", "selenagomez", "cristiano", "narendramodi", "potus", "cnn", "bbcworld", "nytimes", "reuters", "bloomberg", "nasa", "spacex", "tesla", "apple", "google", "microsoft", "amazon", "netflix", "openai", "ylecun", "karpathy", "sundarpichai", "tim_cook", "satyanadella", "jeffbezos", "shakira", "kimkardashian", "arianagrande", "drake", "beyonce", "katyperry", "arishlp", "jeffdean", "demishassabis", "ilyasut", "andrewyng", "pmarca", "balajis", "palmerluckey", ], } # Run the Actor and wait for it to finish run = client.actor("parseforge/x-com-profiles-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 '{ "maxItems": 10, "twitterHandles": [ "elonmusk", "sama", "naval", "paulg", "garrytan", "vitalikbuterin", "jack", "barackobama", "billgates", "justinbieber", "taylorswift13", "rihanna", "selenagomez", "cristiano", "narendramodi", "potus", "cnn", "bbcworld", "nytimes", "reuters", "bloomberg", "nasa", "spacex", "tesla", "apple", "google", "microsoft", "amazon", "netflix", "openai", "ylecun", "karpathy", "sundarpichai", "tim_cook", "satyanadella", "jeffbezos", "shakira", "kimkardashian", "arianagrande", "drake", "beyonce", "katyperry", "arishlp", "jeffdean", "demishassabis", "ilyasut", "andrewyng", "pmarca", "balajis", "palmerluckey" ] }' | apify call parseforge/x-com-profiles-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/x-com-profiles-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "X.com Profiles Scraper", "description": "Extract comprehensive profile data from X.com (Twitter) including follower counts, verification status, bio, join dates, and 40+ data points. Collect usernames, profile images, location, pinned posts, and professional info. Perfect for marketers, researchers, recruiters, and social media analysts.", "version": "1.0", "x-build-id": "DPvnwbPyB3I9t90lI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~x-com-profiles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-x-com-profiles-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/parseforge~x-com-profiles-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-x-com-profiles-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/parseforge~x-com-profiles-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-x-com-profiles-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", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct X.com URLs to scrape. Supports profile URLs and tweet URLs. Use this OR the filters below, not both.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of profiles to collect (Free users: Limited to 10. Paid users: Optional, max 1,000,000). Leave empty for unlimited." }, "twitterHandles": { "title": "Twitter Handles", "type": "array", "description": "List of X.com handles (without @). Use this OR startUrls, not both.", "items": { "type": "string" } }, "twitterUserIds": { "title": "Twitter User IDs", "type": "array", "description": "List of X.com user IDs to scrape profiles from. Can be used together with twitterHandles.", "items": { "type": "string" } }, "filterByBlueVerified": { "title": "Filter by Blue Verified", "type": "boolean", "description": "If true, return only X Premium (blue verified) accounts. If false, return only non-blue-verified accounts. Leave empty for all." }, "filterByProfessionalType": { "title": "Filter by Professional Type", "enum": [ "", "Creator", "Business" ], "type": "string", "description": "Return only accounts of a specific professional type. Options: Creator, Business. Leave empty for all." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure Apify proxy for requests." } } }, "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 } } } } } } } } } } ```