# X (Twitter) Profile Scraper | $0.00015/Profile | Pay-Per-Result (`xquik/x-profile-scraper`) Actor Twitter profile scraper. Use it as a Twitter profile viewer for X profiles in bulk by handle, ID or URL, from $0.00015 per delivered row. Get the emails, phones & links each account publishes. No X account needed. World's fastest & cheapest X (Twitter) scraper service. Not affiliated with X Corp. - **URL**: https://apify.com/xquik/x-profile-scraper.md - **Developed by:** [Xquik](https://apify.com/xquik) (community) - **Categories:** Social media, Lead generation, Automation - **Features:** Limited permissions - **Stats:** 544 total users, 236 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.00015 / profiles This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README **English** · [Español](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.es.md) · [Türkçe](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.tr.md) · [简体中文](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.zh-CN.md) · [日本語](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.ja.md) · [한국어](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.ko.md) · [Deutsch](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.de.md) · [Français](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.fr.md) · [Italiano](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-profile-scraper/README.it.md) [![Framer connects Xquik MCP to coding agents](https://img.youtube.com/vi/4UOSpoOoC3Y/maxresdefault.jpg)](https://youtu.be/4UOSpoOoC3Y?t=367)\ [Watch how Framer uses Xquik scrapers](https://youtu.be/4UOSpoOoC3Y?t=367) with Claude Code, Codex, Cursor & more, from 6:07. Xquik is the world's fastest & cheapest X (Twitter) scraper service with the most complete X data. Xquik's X (Twitter) Profile Scraper collects profiles, posts, replies, media & followers for any handle. Most other Apify Actors charge before filtering or deduplicating. Xquik charges only for delivered, unique, filter-matching results. Look up Twitter accounts in bulk & read profiles without an X account. Scrape X profiles, posts, replies, media & followers from handles, IDs or URLs. You pay **$0.00015 per delivered row**, & Apify bills platform usage separately. You need no X account or X API key. > Xquik is an independent third-party service. Not affiliated with X Corp. > "Twitter" and "X" are trademarks of X Corp. ### What does X (Twitter) Profile Scraper do? Xquik's X (Twitter) Profile Scraper returns public X (Twitter) profiles from handles, numeric user IDs or profile URLs. Each profile can add its posts, replies, media, Highlights, followers, following & verified followers. It also translates bios & checks who broadcasts live now. #### Use cases - Enrich lead lists with bios, websites, locations & audience size. - Compare competitor accounts by followers, posts & verification. - Vet creators by audience, account age & engagement. - Archive an account's posts, media & Highlights. - Map an account's network through its followers & following. - Watch creators & brands for live broadcasts. - Read bios from other markets in your own language. ### Why use X (Twitter) Profile Scraper? - **Whole account in 1 run.** Give handles, IDs or URLs. Add posts, replies, media, Highlights, followers, following or verified followers as rows. - **Live broadcast check.** `checkLiveNow` says who is live now, with their latest broadcast. - **Published contacts in each row.** `email` & `contactInfo` hold the emails, phones & links a profile publishes. Keep only business emails or domains you pick. - **Account origin & history.** `accountBasedIn` holds X's country or region label. `usernameChanges` shows how often a handle changed. - **Filters for profiles & posts.** Keep profiles by audience size, account age & verification. Keep posts by date, language, media & engagement. #### Complete results - Account history comes back complete, old posts included. - Profile exports keep every post of the author's own threads. - Profile reads include the pinned post, flagged as pinned. - Follower & following exports return full lists. - Verified follower exports return full lists too. - Each answer holds the fullest data X has for it. #### Accurate rows - Reposts carry the full original text. - Every ID in a row stays exact. - Mentions, links, hashtags & highlights line up with the text. - Verified badges match what `x.com` shows. - Rows hold public data only. - Ads & promoted entries never reach your rows. #### Fresh data - Reads keep working when X ships changes. #### Speed - One slow page doesn't hold up your run. - Reads finish the moment their rows arrive. - Stalled Actor calls recover on their own. #### Fair billing - Bad input costs nothing & tells you what to fix. - Actors charge only for delivered, unique, matching rows. - A profile shared by several targets is billed once. - A restarted run never charges twice. - Runs stay within your spend cap & still write their diagnostics. - Small runs end with a tip that cuts cost. #### Reliability - A one-off error doesn't fail your run. - A deadline returns the rows already found, with diagnostics. - Actors ride out short Xquik outages. - Actor runs survive restarts without repeats. - One bad row doesn't sink a batch. - Stopped runs keep their rows & their report. - A run that can't start still explains itself. - Support can see exactly what a request or run returned. #### Built for agents - Actors accept input written for other Actors. - Output is ready for spreadsheets, with flat columns & engagement totals. - Every run says why it ended & whether to retry. #### Rich data - Posts carry note text, edits, Community Notes, reach labels, reply controls & live events. - Rows carry source apps, media counts & professional account data. - Media comes with variants, alt text, sizes & availability reasons. - Posts & bios can be translated into your language. - Account checks say if each account is active, protected, suspended or missing. #### Quality checks - Every field X shows is served, left out on purpose or proven absent. - Xquik tests every read live against X. ### What data can X (Twitter) Profile Scraper extract? Profile rows use `resultType: "profile"`. These are the main fields. | Field | Description | | ------------------------ | ----------------------------------------------- | | `id` | Numeric user ID | | `username` | Handle without `@` | | `name` | Display name | | `description` | Bio text | | `url` | Website on profile rows | | `location` | Location the owner typed | | `email` | First email the profile publishes | | `contactInfo` | Emails, phones & links the profile publishes | | `followers` | Follower count | | `following` | Following count | | `statusesCount` | Post count | | `mediaCount` | Media post count | | `favouritesCount` | Likes the account gave | | `listedCount` | Public Lists that include the account | | `createdAt` | Account creation time | | `verified` | Whether X reports verification | | `isBlueVerified` | Whether the account has X Blue verification | | `verifiedType` | Verification category, such as `Government` | | `profilePicture` | Profile image URL at 48 px | | `profilePictureOriginal` | The same image at full size, to download | | `coverPicture` | Banner image URL | | `pinnedTweetIds` | Pinned post IDs | | `professional` | Professional category & type | | `accountBasedIn` | X's best-effort country or region label | | `connectedVia` | How the account first connected to X | | `usernameChanges` | How often the handle changed & when it last did | | `birthdate` | Birthday parts the account made public | | `subscribersCount` | Subscriber count, when X sends it | | `tipJar` | Public tipping links | | `protected` | Whether the account protects its posts | | `redirectsToUsername` | Handle X redirects the profile to | | `unavailable` | Whether the account is unavailable | | `sourceTarget` | The handle, ID or URL you entered | The dataset schema documents every other field, such as `identityVerification`, `isAutomated`, `automatedBy`, `withheldInCountries` & `verificationReason`. Optional rows keep the Xquik REST response shape. | `resultType` | Turned on by | One row per | | ------------------------- | -------------------------- | ----------------- | | `profileTweet` | `includeTweets` | Post | | `profileReply` | `includeReplies` | Post or reply | | `profileMedia` | `includeMedia` | Media post | | `profileHighlight` | `includeHighlights` | Highlighted post | | `profileFollower` | `includeFollowers` | Follower | | `profileFollowing` | `includeFollowing` | Followed account | | `profileVerifiedFollower` | `includeVerifiedFollowers` | Verified follower | | `profileBioTranslation` | `translateBioTo` | Translated bio | | `profileLive` | `checkLiveNow` | Checked profile | | `accountStatus` | `mode: "accountStatus"` | Named account | Rows never include viewer-only state, such as whether you follow or block an account. ### How do I use X (Twitter) Profile Scraper to scrape profile data? New to Apify? [Create a free account](https://console.apify.com/sign-up?fpr=xquik) first. The free plan needs no credit card & gives $5 to spend each month. At $0.00015 per row, $5 pays for up to 33,000 rows before platform usage. Then come back here & press Try for free. Follow these steps in Apify Console. 1. Open a [task example](#task-examples) or the Input tab. 2. Add handles to X Handles, URLs to Profile URLs or IDs to Numeric User IDs. 3. Turn on the rows you need, such as Include Posts. Rows per Profile at 1 gives each profile's latest post. 4. Set Maximum Delivered Rows & any filters, then click Start. 5. Export the dataset as JSON, CSV, Excel or HTML. Each recipe below is a complete input. #### Scrape many profiles ```json { "twitterHandles": ["nasa", "OpenAI", "apify"], "maxItems": 100 } ``` Each handle returns 1 profile row. Handles work with or without `@`. #### Paste profile URLs or IDs `startUrls` takes each URL as a plain string or as a `{ "url": "..." }` object. `userIds` takes numeric X user IDs. ```json { "startUrls": ["https://x.com/nasa", { "url": "https://x.com/OpenAI" }], "userIds": ["11348282"], "maxItems": 100 } ``` The run reads a repeated handle once. #### Add posts, replies & media ```json { "twitterHandles": ["nasa"], "includeTweets": true, "includeMedia": true, "sinceDate": "2026-01-01", "maxItems": 500 } ``` `includeTweets` adds the profile's posts. `includeReplies` adds its posts & replies. `includeMedia` adds its media posts. `includeHighlights` adds its highlighted posts, in X's order. A profile without highlights adds no rows. #### Keep only popular posts ```json { "twitterHandles": ["nasa"], "includeTweets": true, "minLikes": 1000, "mediaType": "videos", "maxItems": 200 } ``` Post filters apply to optional post rows. Filtered rows never reach the dataset, so you never pay for them. #### Export followers & following ```json { "twitterHandles": ["apify"], "includeFollowers": true, "minFollowers": 1000, "verifiedOnly": true, "maxItems": 1000 } ``` `includeFollowers`, `includeFollowing` & `includeVerifiedFollowers` add 1 profile row per account. Profile filters apply to these rows & to the main profiles. #### Translate bios ```json { "twitterHandles": ["nasa", "SpaceX"], "translateBioTo": "es" } ``` Each translation is 1 `profileBioTranslation` row with `text`, `language` & `sourceLanguage`. A profile without a bio adds no row & no charge. #### Check who is live now ```json { "twitterHandles": ["nasa", "SpaceX"], "checkLiveNow": true } ``` Each check is 1 `profileLive` row with `live`, `userId`, `userName` & `broadcast`. `broadcast` holds the profile's latest broadcast, live or ended, or null. A missing profile adds no row. #### Check if accounts are suspended ```json { "twitterHandles": ["nike", "adidas", "puma"], "mode": "accountStatus" } ``` Each account is 1 `accountStatus` row at $0.00015, even when X shows no profile. `accountStatus` is `active`, `suspended` or `not_found`. An active row holds the full profile & `protected`. A suspended or missing row holds only `accountStatus`, `resultType` & `sourceTarget`. This mode adds no posts, followers or other rows. ### Task examples Choose from 50 public tasks. Each has a bounded input & a matching dataset view. Edit a task before you run it. - [Get the profile card of one X account](https://apify.com/xquik/x-profile-scraper/examples/get-an-x-profile-card) - [Compare the profiles of competing brands](https://apify.com/xquik/x-profile-scraper/examples/compare-competitor-brand-profiles) - [Resolve numeric user IDs to profiles](https://apify.com/xquik/x-profile-scraper/examples/resolve-numeric-user-ids-to-profiles) - [Collect the recent posts of one account](https://apify.com/xquik/x-profile-scraper/examples/collect-recent-posts-from-an-account) - [Find the most liked posts of an account](https://apify.com/xquik/x-profile-scraper/examples/find-an-accounts-most-liked-posts) - [Collect the videos an account posts](https://apify.com/xquik/x-profile-scraper/examples/collect-videos-from-an-account) - [Archive one calendar year of an account](https://apify.com/xquik/x-profile-scraper/examples/archive-one-year-of-posts) - [Export the followers of an account](https://apify.com/xquik/x-profile-scraper/examples/export-the-followers-of-an-account) - [Export the verified followers of a company](https://apify.com/xquik/x-profile-scraper/examples/export-verified-followers) - [Find followers with 10,000 or more followers](https://apify.com/xquik/x-profile-scraper/examples/find-influential-followers) - [Measure the audience overlap of 2 design tools](https://apify.com/xquik/x-profile-scraper/examples/measure-audience-overlap) - [Run a full audit of one account](https://apify.com/xquik/x-profile-scraper/examples/run-a-full-account-audit) ### How much does it cost to scrape X profiles? Xquik's X (Twitter) Profile Scraper costs $0.00015 per delivered row on every Apify plan. Apify bills your platform usage separately. Xquik applies one charge per delivered data row. Diagnostics are free in the `diagnostics` output. For more volume, [pick an Apify plan](https://apify.com/pricing?fpr=xquik) with more prepaid usage. - You need no Xquik subscription. - You pay no separate start, profile or query fee. - Filters & deduplication run before billing. You never pay for filtered or duplicate rows. - A profile without a bio adds no translation charge. - A missing profile adds no live check charge. - Apify maximum-total-charge settings cap delivered rows. A run that hits a problem, or a large run, also writes a `run-report` record. A small run that goes well skips it & saves Apify usage. Turn on `alwaysSaveRunRecords` to write it on every run. To cap what a run can spend, see [Run options](#run-options). ### Empty, partial & stopped runs Xquik's X (Twitter) Profile Scraper explains empty, partial & stopped runs for free. The run status says why the run stopped. It also counts charged results & targets read. #### Empty results An empty run's status says to check your targets & filters. Filtered rows never use up your result limit. A run that reads every target & gets no row back writes no record. Its status says why & what to change. X has shown the posts an account liked only to that account since 2024. `includeLikes` returns no `profileLike` rows for other accounts. #### Partial runs Interrupted extraction writes a free `partial` diagnostic. Delivered rows stay in the dataset. Read `availableResults`, `failedTargets`, `retryable` & `nextAction` before you retry. A successful Actor exit confirms delivery, not complete extraction. #### Stop causes The run status names every cause of an early stop. `stopCauses` lists each cause with its own `message`, `retryable` & `nextAction`. The causes are `target_not_found`, `target_suspended`, `target_failed`, `pagination_safety_limit` & `deadline_reached`. `target_suspended` names the accounts X suspended. A missing or suspended target joins the list only when another cause stopped the run. The run is `retryable` when any cause is. ### Input The Input tab lists every option. Give at least 1 of `twitterHandles`, `startUrls` or `userIds`. Every other field is optional. | Field | What it does | | ------------------------------ | ----------------------------------------------------- | | `twitterHandles` | Handles, with or without `@` | | `startUrls` | Profile URLs on `x.com` or `twitter.com` | | `userIds` | Numeric X user IDs | | `mode` | `profiles`, or `accountStatus` for 1 status row each | | `maxItems` | Cap on delivered rows across the whole run | | `maxItemsPerTarget` | Cap for each profile or resource, newest posts first | | `includeTweets` | Add the profile's posts | | `includeReplies` | Add its posts & replies | | `includeMedia` | Add its media posts | | `includeHighlights` | Add its highlighted posts | | `includeLikes` | Add liked posts, which X hides from other accounts | | `includeFollowers` | Add followers | | `includeFollowing` | Add followed accounts | | `includeVerifiedFollowers` | Add verified followers | | `translateBioTo` | Translate each bio into a language code, such as `es` | | `checkLiveNow` | Check whether each profile broadcasts live now | | `sinceDate`, `untilDate` | Keep posts inside a date window | | `language` | Keep posts in 1 language code | | `mediaType` | Keep posts with images, videos, GIFs, links or none | | `minViews`, `minLikes` | Keep posts above a view or like count | | `minReplies`, `minRetweets` | Keep posts above a reply or repost count | | `retweets` | `exclude` drops reposts, `only` keeps only reposts | | `verifiedOnly` | Keep verified authors or profiles | | `blueVerifiedOnly` | Keep authors or profiles X marks as blue verified | | `verifiedType` | Keep profiles with 1 verification type | | `minFollowers`, `maxFollowers` | Keep profiles inside an audience range | | `minAccountAgeDays` | Keep profiles at least this many days old | | `minFollowing`, `maxFollowing` | Keep profiles inside a following range | | `minStatuses`, `maxStatuses` | Keep profiles inside a post count range | | `hasWebsite`, `hasLocation` | Keep profiles that list a website or a location | | `hasEmail` | Keep profiles that publish an email | | `businessEmailOnly` | Keep profiles with an email outside free mail | | `emailDomains` | Keep profiles with an email at these domains | | `bioContains` | Keep profiles whose bio has 1 of these words | | `locationContains` | Keep profiles whose location has this text | | `usernameContains` | Keep profiles whose username has this text | | `dedupeAcrossTargets` | Drop rows repeated across profiles before billing | #### Migrate from another profile Actor Paste the input you already use. Xquik's X (Twitter) Profile Scraper reads these field names of other profile Actors. Each line names their fields, then the field they map to. - `profiles`, `userNames`, `usernames`, `handles`, `screenNames` map to `twitterHandles`. - `urls`, `profileUrls` map to `startUrls`. - `maxProfiles`, `maxResults` map to `maxItems`. - `shouldScrapeFollowers`, `shouldScrapeFollowings` map to `includeFollowers`, `includeFollowing`. - `requireEmail` maps to `hasEmail`. - `requireWebsite` maps to `hasWebsite`. It keeps a profile with any link in its website field, & the run status says so. - `filterByBlueVerified` maps to `blueVerifiedOnly`. `false` stops the run before any read or charge. - `bioKeywords` maps to `bioContains`. Any 1 of its terms may match. - `locationKeywords` with 1 value maps to `locationContains`. More values stop the run before any read or charge. - `emailDomains` as a list maps to `emailDomains`. - `nativeRetweets`, the old Native Reposts Only, maps to `retweets` set to `only`. - `outputEmail`, `resolveShortLinks` need no field. Every row carries its emails & X's full links. - `findEmails`, `extractEmails` need no field. Rows carry the emails a profile publishes on X. The run status says the Actor reads no linked site. - `validateEmails` needs no field. The run status says emails come as published, since the Actor checks no mailbox. `category` set to `user_info` changes nothing. A category that is another Actor's job, such as `tweets` or `followers`, stops the run. It reads & charges nothing. The message names the Actor to use. When you set an alias & its canonical field, the canonical value wins. The run log names the alias that lost. #### Pick the right inputs - For a profile card alone, give handles & leave every `include` option off. - For an account archive, turn on `includeTweets`, `includeMedia` & `includeHighlights`, & set `sinceDate`. - For top content, add `minLikes` or `minViews` to `includeTweets`. - For lead lists, turn on `includeFollowers` with `minFollowers` & `minAccountAgeDays`. - For audience overlap, give 2 handles, turn on `includeFollowers` & set `dedupeAcrossTargets: false`. A shared follower then appears under each handle. ### Output Each row is a JSON object. The dataset schema gives each field a title & description, so AI agents can read rows without guessing. Examples use sample values. Results reflect live data. A profile row looks like this. ```json { "resultType": "profile", "sourceTarget": "sample_user", "id": "1234567890", "username": "sample_user", "name": "Sample User", "description": "Building tools for researchers.", "url": "https://example.com", "location": "Lisbon", "followers": 1200, "following": 310, "statusesCount": 4200, "verified": false, "createdAt": "Tue Mar 21 20:50:14 +0000 2017", "accountBasedInUnavailable": true } ``` X infers `accountBasedIn` from aggregated account-access IPs. The label does not state nationality, residence, identity, signup, post or exact location. `observedAt` records retrieval time. `accountBasedIn` is null when X shows no label. When X withholds it, the row has `accountBasedInUnavailable: true` instead. Export the dataset as JSON, CSV, Excel or HTML. ### Output columns 8 inputs shape each row after the run reads it. They run no code & change no price. | Field | What it does | | ------------------- | ----------------------------------------------------------- | | `fields` | Keep only these fields, in the order & spelling you write | | `omitFields` | Drop these fields & keep the rest | | `renameFields` | Move a field to a column with a new name | | `flatten` | Turn each nested object into top-level columns | | `fillMissingFields` | Fill a kept field a row lacks with `null`. On by default | | `joinFields` | Turn each of these lists into 1 text value | | `joinSeparator` | Text between joined items. The default is a comma & a space | | `constantFields` | Add a column with the same text on every row | - Use a dot for a field inside an object, such as `accountBasedIn.value`. Case & underscores do not matter. - Every row keeps its `id`. - With `fields`, a field a row lacks arrives as `null`. Every row then has the same columns. - A wrong field name stops the run before it reads & charges nothing. - If names cannot be checked, the run reads on & lists unseen names last. - The run ignores a map function or jq filter written for another Actor. Name a computed column in `fields` or `renameFields` to add it. | Column | Formula | | ------------------- | ---------------------------------------------------------------------------------- | | `totalEngagement` | `likeCount` + `replyCount` + `retweetCount` + `quoteCount`. A missing count adds 0 | | `engagementRate` | `totalEngagement` × 100 ÷ the author's `followers`, to 4 decimals | | `engagementPerView` | `totalEngagement` × 100 ÷ `viewCount`, to 4 decimals | `totalEngagement` is `null` for a row without those counts. A rate is `null` when its divisor is missing or 0. ### Run options - Set Apify's max total charge to cap run cost. Leave `maxItems` high to get the most rows that budget allows. - Set `maxTotalChargeUsd` in the Apify API, or Max cost per run in Console. - Put all your profiles in 1 run. Each run pays Apify the same start cost. - `maxConcurrency` sets how many profiles run at once. The default is the fastest safe setting. - Use Xquik account monitors for 1-second checks & signed webhooks. Active monitors check every second. Select `latest` for every run to get every published fix. Saved tasks & schedules keep their own build choice, so keep it on `latest`. ### Related Xquik Actors Every Xquik Actor shares the same extraction engine, filter-first billing & diagnostics. Pick the one that matches the data you need. - [X (Twitter) Tweet Scraper](https://apify.com/xquik/x-tweet-scraper) scrapes tweets from searches, profile timelines, Lists & tweet IDs with 50+ filters & flat exports. Use it when you need tweet data without analysis. From $0.00015 per row. - [X (Twitter) Reply Scraper](https://apify.com/xquik/x-reply-scraper) scrapes replies, comments & whole conversations under posts with 25+ filters. Use it when you need the discussion beneath tweets. From $0.00015 per row. - [X (Twitter) Engagement Scraper](https://apify.com/xquik/x-engagement-scraper) scrapes replies, quotes, retweeters & threads for post URLs or IDs in bulk. Use it when you measure who engaged with posts. From $0.00015 per row. - [X (Twitter) Quote Tweets Scraper](https://apify.com/xquik/x-quote-tweets-scraper) scrapes the quote tweets of posts with text, media, counts, authors & 11 filters. Use it when you study who quoted posts & what they said. From $0.00015 per tweet. - [X (Twitter) Follower Scraper](https://apify.com/xquik/x-follower-scraper) scrapes followers, following, List members, subscribers & Community members as profile rows. Use it when you need audience or member lists. From $0.00015 per profile. - [X (Twitter) User Search Scraper](https://apify.com/xquik/x-user-search-scraper) searches users by handle, bio & location with follower, verification, age & location filters. Use it when you build account lists from search. From $0.00015 per profile. - [X (Twitter) Account Location Scraper](https://apify.com/xquik/x-account-location-scraper) checks where accounts are based with X's "Account based in" label, "connected via" & username changes. Use it when you vet where accounts are based. From $0.00015 per account. - [X (Twitter) Email Scraper](https://apify.com/xquik/x-email-scraper) gets the emails, phones & links accounts publish on their profiles, from handles, followers or user searches. Use it when you need the emails profiles publish. From $0.00015 per profile. - [X (Twitter) List Scraper](https://apify.com/xquik/x-list-scraper) scrapes List posts, members & followers from List URLs or IDs. Use it when a curated List defines your sources. From $0.00015 per row. - [X (Twitter) Community Scraper](https://apify.com/xquik/x-community-scraper) scrapes Community info, posts, searches, members & moderators. Use it when your sources are X Communities. From $0.00015 per row. - [X (Twitter) Space Scraper](https://apify.com/xquik/x-space-scraper) finds Spaces by keyword & reads their titles, states, times, listener counts, hosts & speakers. It also reads broadcasts by URL or ID. Use it when you track live audio & video on X. From $0.00015 per Space or broadcast. - [X (Twitter) Trends Scraper](https://apify.com/xquik/x-trends-scraper) scrapes real-time trends by location with rank, volume, query & WOEID. Use it when you track what is trending where. From $0.00015 per trend. - [X (Twitter) Jobs Scraper](https://apify.com/xquik/x-job-scraper) scrapes X job listings by keyword, place, workplace, seniority & company, with salaries & apply links. Use it when you collect job openings posted on X. From $0.00015 per job. - [X (Twitter) Article Scraper](https://apify.com/xquik/x-article-scraper) scrapes long-form X Articles as Markdown & text with covers, authors, dates & metrics. Use it when you need article bodies, not tweets. From $0.00015 per article. - [X (Twitter) Media Downloader](https://apify.com/xquik/x-media-downloader) extracts or stores photos, videos & GIFs from posts or profiles with MP4 & metadata options. Use it when you need the media files themselves. From $0.00015 per media row. - [X (Twitter) Brand Monitoring with AI Analysis](https://apify.com/xquik/x-twitter-brand-monitoring) tracks brand mentions with AI relevance, sentiment & customer-experience answers & compares runs. Use it when you watch a brand over time. From $0.0003 per analyzed tweet. - [X (Twitter) Tweet Sentiment Analysis with AI](https://apify.com/xquik/x-tweet-sentiment-analysis) labels attitude, intensity & sarcasm probability for every tweet with AI. Use it when you need general sentiment on any topic. From $0.0003 per analyzed tweet. - [X (Twitter) Stock & Crypto AI Trading Signals](https://apify.com/xquik/x-twitter-stock-crypto-signals) labels bullish, bearish, neutral or mixed stance, content type, conviction & asset relevance with AI. Use it when you follow stocks, crypto or trading talk. From $0.0003 per analyzed tweet. - [X (Twitter) News Monitor with AI Analysis](https://apify.com/xquik/x-twitter-news-monitor) labels news posts by format, source attribution & topic relevance with AI. Use it when you separate reporting from commentary. From $0.0003 per analyzed tweet. - [X (Twitter) Tweet Classifier with AI Analysis](https://apify.com/xquik/x-twitter-tweet-classifier) answers your own category, score & yes/no questions for every tweet with AI. Use it when the preset analyses do not fit your labels. From $0.0003 per analyzed tweet. - [X (Twitter) Tweet Viral Score Analyzer with AI](https://apify.com/xquik/x-tweet-viral-score-analyzer) estimates a Viral Score from 0 to 100 & a verdict for every tweet from 8 AI trait answers. Use it when you study why tweets spread or flop. From $0.0003 per analyzed tweet. - [X (Twitter) Monitor](https://apify.com/xquik/x-twitter-monitor) catches every new tweet, reply, quote, repost & profile change of accounts, usually in under a second after X shows it, plus keyword tweets & follows. Use it when you need alerts as soon as X shows a tweet. From $0.0045 per monitor-hour. - [X (Twitter) to Discord Bot](https://apify.com/xquik/x-twitter-to-discord) sends every new tweet, reply, quote & repost of accounts to a Discord channel through its webhook, with no bot to host. Use it when you want an account's tweets in a Discord channel. From $0.0045 per monitor-hour. - [X (Twitter) Crypto Tracker](https://apify.com/xquik/x-twitter-crypto-tracker) tracks the tweets, deleted tweets, profile changes & follows of crypto accounts & KOLs, plus cashtag tweets. Use it when you act on what crypto accounts post or follow. From $0.0045 per monitor-hour. - [X (Twitter) Follower Tracker](https://apify.com/xquik/x-twitter-follower-tracker) tracks the new & lost followers of an account, & whom it follows or unfollows, with each account's full profile. Use it when you read an account's followers or follows as a signal. From $0.0045 per monitor-hour. - [X (Twitter) Post Tracker](https://apify.com/xquik/x-twitter-post-tracker) records the views, likes, reposts, replies, quotes & bookmarks of chosen posts on each run, with the change since the last run. Use it when you track how posts perform over time. From $0.00015 per snapshot. ### FAQ Answers to common questions, then where to get help. #### Do I need an X account or an X API key? No. Xquik's X (Twitter) Profile Scraper needs no X account or X API key. #### How many profiles can I scrape in 1 run? As many as you list. `maxItems` & your Apify spend limit cap the rows. #### Can I export X profiles to CSV or Excel? Yes. Export the dataset as JSON, CSV, Excel or HTML from the Storage tab. #### Can I scrape a Twitter user's followers? Yes. Turn on `includeFollowers`, `includeFollowing` or `includeVerifiedFollowers`. Each account is 1 row. #### Does it get a profile's website & location? Yes. `url` holds the website & `location` holds the text the owner typed. Set `hasWebsite` & `hasLocation` to keep only profiles that list them. #### Can I scrape protected accounts? You get the public profile row, with `protected: true`. X shows a protected account's posts & followers only to its approved followers. #### How do I know if an account is live now? Set `checkLiveNow: true`. Each profile gets a `profileLive` row with `live` & its latest broadcast. #### Can it translate bios? Yes. Set `translateBioTo` to a language code, such as `es` or `pt-br`. A profile without a bio adds no row. #### Why does includeLikes return nothing? X has shown the posts an account liked only to that account since 2024. Other accounts, this Actor included, can't read them. #### Is it legal to scrape X profiles? Xquik's X (Twitter) Profile Scraper requests public X fields. Results can contain personal data. Confirm a lawful purpose & follow applicable privacy rules. Ask qualified counsel when uncertain. #### Why did my run return no results? Read the run status first. An empty run's status says to check your targets & filters. The free `diagnostics` output appears when something needs attention. Its `stopCauses` gives each cause a `nextAction` to follow. The run lists each input it cannot read & says how to fix it. #### Can I use the API, schedules & integrations? Yes. Choose from 50 public tasks or the Xquik REST API. The [API tab](https://apify.com/xquik/x-profile-scraper/api) has Python, JavaScript & cURL examples. Apify [schedules](https://docs.apify.com/platform/schedules) run Xquik's X (Twitter) Profile Scraper on a cron. Agents use [Apify MCP](https://docs.apify.com/platform/integrations/mcp). Use `latest` unless you need an older build. #### Can I get a custom solution? Yes. Describe what you need in the [Issues tab](https://apify.com/xquik/x-profile-scraper/issues). Xquik also offers a dashboard, a REST API, an MCP server & webhooks. Find Xquik's website on its [Apify profile](https://apify.com/xquik). #### Where do I get help? Open an issue in the [Issues tab](https://apify.com/xquik/x-profile-scraper/issues) with the run ID. Free diagnostics in the key-value store explain runs that need attention. A run that gets no row back says why in its status. # Changelog This Actor's version history is a separate document: https://apify.com/xquik/x-profile-scraper/changelog.md # Actor input Schema ## `startUrls` (type: `array`): Public x.com or twitter.com profile URLs. Use strings or {"url":"..."} objects. For example, \["https://x.com/nasa", {"url":"https://x.com/OpenAI"}]. ## `twitterHandles` (type: `array`): Usernames with or without @. ## `userIds` (type: `array`): Numeric X user IDs. ## `mode` (type: `string`): Profiles returns full profiles & the rows you turn on. Account Status says whether each account is active, suspended or not found. Each account is 1 row. ## `maxItems` (type: `integer`): Global cap across profiles and optional timeline rows. The form starts at 1,000. A run can return 100,000 rows & more, so raise it for a full export. ## `maxItemsPerTarget` (type: `integer`): Cap for each profile & each resource you turn on. Posts come newest first, so 1 gives each profile's latest post. ## `includeTweets` (type: `boolean`): Add each profile's public posts, newest first, as separate billed rows. ## `includeReplies` (type: `boolean`): Add public Profile With Replies rows. ## `includeMedia` (type: `boolean`): Add each profile's posts with photos, videos or GIFs. ## `includeHighlights` (type: `boolean`): Add the posts each profile highlights. ## `includeLikes` (type: `boolean`): X has shown the posts an account liked only to that account since 2024, so this option returns no rows for other accounts. ## `includeFollowers` (type: `boolean`): Add the followers of each profile. ## `includeFollowing` (type: `boolean`): Add the accounts each profile follows. ## `includeVerifiedFollowers` (type: `boolean`): Add the verified followers of each profile. ## `translateBioTo` (type: `string`): Language code to translate each profile bio into, such as es, tr or pt-br. Each translated bio is 1 row. ## `checkLiveNow` (type: `boolean`): Check whether each profile broadcasts live on X now. Each check is 1 row. ## `sinceDate` (type: `string`): Keep optional post rows on or after this date. ## `untilDate` (type: `string`): Keep optional post rows on or before this date. ## `language` (type: `string`): Keep optional posts with this language code. ## `mediaType` (type: `string`): Keep optional posts with the selected media type. ## `minViews` (type: `integer`): Keep optional posts with at least this many views. ## `minLikes` (type: `integer`): Keep optional posts with at least this many likes. ## `minReplies` (type: `integer`): Keep optional posts with at least this many replies. ## `minRetweets` (type: `integer`): Keep optional posts with at least this many reposts. ## `retweets` (type: `string`): Leave empty to keep reposts. Exclude Reposts keeps original posts only. ## `verifiedOnly` (type: `boolean`): Keep optional posts or profiles with verified authors. ## `blueVerifiedOnly` (type: `boolean`): Keep posts, or profiles & optional profile rows, with X's blue mark. X marks many business & government accounts blue too. ## `verifiedType` (type: `string`): Keep profiles & optional profile rows with this verification type, such as business. ## `minFollowers` (type: `integer`): Keep profiles & optional profile rows above this audience size. ## `maxFollowers` (type: `integer`): Keep profiles & optional profile rows below this audience size. ## `minFollowing` (type: `integer`): Keep profiles & optional profile rows who follow at least this many accounts. ## `maxFollowing` (type: `integer`): Keep profiles & optional profile rows who follow at most this many accounts. ## `minStatuses` (type: `integer`): Keep profiles & optional profile rows with at least this many posts. ## `maxStatuses` (type: `integer`): Keep profiles & optional profile rows with at most this many posts. ## `minAccountAgeDays` (type: `integer`): Keep profiles & optional profile rows at least this old. ## `hasWebsite` (type: `boolean`): Keep profiles & optional profile rows that list a website. ## `hasLocation` (type: `boolean`): Keep profiles & optional profile rows that list a location. ## `hasEmail` (type: `boolean`): Only include users whose profile publishes an email. ## `businessEmailOnly` (type: `boolean`): Only include users who publish an email outside free webmail, such as Gmail. ## `emailDomains` (type: `string`): Only include users with an email at one of these domains. Separate domains with commas. Subdomains match. For example, acme.com, stanford.edu. ## `bioContains` (type: `string`): Keep profiles & optional profile rows with any of these words in their bio. Separate words with commas. ## `locationContains` (type: `string`): Keep profiles & optional profile rows whose location contains this text. ## `usernameContains` (type: `string`): Keep profiles & optional profile rows whose username contains this text. ## `dedupeAcrossTargets` (type: `boolean`): Remove repeated canonical rows before billing. ## `maxConcurrency` (type: `integer`): How many profiles to process at once. The default is the fastest safe setting. ## `fields` (type: `array`): Keep only these fields in each row. Pick names or type your own. Use a dot for a field inside an object, such as accountBasedIn.value. Columns arrive in the order & spelling you write. Every row keeps its id. Leave empty for every field. The price per row stays the same. A wrong name stops the run before it reads, at no charge. If names cannot be checked, the run reads on & lists unseen names last. ## `omitFields` (type: `array`): Drop these fields & keep the rest. Every row keeps its id. ## `renameFields` (type: `array`): Give a field a new column name. The key is the field. The value is the new name. A renamed field becomes a top-level column. ## `flatten` (type: `boolean`): Turn each nested object into top-level columns, such as accountBasedInValue. Lists stay lists. Use it for CSV & spreadsheets. ## `fillMissingFields` (type: `boolean`): With Fields to keep, a field a row lacks arrives as null. Every row then has the same columns. Turn it off to leave such fields out. ## `joinFields` (type: `array`): Turn each of these lists into 1 text value. Use it for CSV cells. ## `joinSeparator` (type: `string`): Text between the items of a joined list. ## `constantFields` (type: `array`): Add a column with the same text on every row. The key is the column name, such as campaign. The value is its text. ## `alwaysSaveRunRecords` (type: `boolean`): Save run-report on every run. When off, small runs that go well skip it & cost less. ## Actor input object example ```json { "startUrls": [ "https://x.com/nasa", { "url": "https://x.com/OpenAI" } ], "twitterHandles": [ "OpenAI", "NASA", "github" ], "mode": "profiles", "maxItems": 1000, "includeTweets": false, "includeReplies": false, "includeMedia": false, "includeHighlights": false, "includeLikes": false, "includeFollowers": false, "includeFollowing": false, "includeVerifiedFollowers": false, "checkLiveNow": false, "verifiedOnly": false, "blueVerifiedOnly": false, "verifiedType": "business", "hasWebsite": false, "hasLocation": false, "hasEmail": false, "businessEmailOnly": false, "emailDomains": "acme.com", "bioContains": "founder", "locationContains": "London", "usernameContains": "news", "dedupeAcrossTargets": true, "maxConcurrency": 100, "flatten": false, "fillMissingFields": true, "joinSeparator": ", ", "alwaysSaveRunRecords": false } ``` # Actor output Schema ## `results` (type: `string`): Unique delivered rows. Filters and deduplication run before billing. ## `diagnostics` (type: `string`): Free actionable diagnostics, written only when something needs attention. They cover partial, invalid, aborted & recovered runs. An empty run whose filters removed rows writes 1 too. A run that read every target & got no row back writes none. A partial diagnostic lists each stop cause in stopCauses. Real results remain in the dataset. ## `runReport` (type: `string`): Outcome, completion reason, counts, duration, and privacy-safe anomalies. A run writes it when it hits a problem, is large or has Always save run records on. Small runs that go well skip it & state the outcome in their status. # 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 = { "twitterHandles": [ "OpenAI", "NASA", "github" ], "maxItems": 1000 }; // Run the Actor and wait for it to finish const run = await client.actor("xquik/x-profile-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 = { "twitterHandles": [ "OpenAI", "NASA", "github", ], "maxItems": 1000, } # Run the Actor and wait for it to finish run = client.actor("xquik/x-profile-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "twitterHandles": [ "OpenAI", "NASA", "github" ], "maxItems": 1000 }' | apify call xquik/x-profile-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,xquik/x-profile-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/3PdxhkbM52rM75ehy/builds/mfFrHMKqwyezXm4iE/openapi.json