# X (Twitter) User Search | $0.00015/Profile | Pay-Per-Result (`xquik/x-user-search-scraper`) Actor

Twitter user search. Find X users by name, handle, bio & location. Get the emails, phones & links each profile publishes, from $0.00015 per delivered profile. Filter by followers, age & email. No X account needed. World's fastest & cheapest X (Twitter) scraper service. Not affiliated with X Corp.

- **URL**: https://apify.com/xquik/x-user-search-scraper.md
- **Developed by:** [Xquik](https://apify.com/xquik) (community)
- **Categories:** Social media, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 267 total users, 142 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-user-search-scraper/README.es.md)
·
[Türkçe](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-user-search-scraper/README.tr.md)
·
[简体中文](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-user-search-scraper/README.zh-CN.md)
·
[日本語](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-user-search-scraper/README.ja.md)
·
[한국어](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-user-search-scraper/README.ko.md)
·
[Deutsch](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-user-search-scraper/README.de.md)
·
[Français](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-user-search-scraper/README.fr.md)
·
[Italiano](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-user-search-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) User Search Scraper finds users by
handle, bio & location. Most other Apify Actors charge before filtering or
deduplicating. Xquik charges only for delivered, unique, filter-matching
results.

Run a Twitter user search by name, topic, bio or location. You need no X account
or X API key. You pay **$0.00015 per delivered profile**, & Apify bills platform
usage separately.

> Xquik is an independent third-party service. Not affiliated with X Corp.
> "Twitter" and "X" are trademarks of X Corp.

### Why use X (Twitter) User Search Scraper?

- **Prices in cashtag suggestions.** In `autocomplete` mode, cashtag rows carry
  `price`, `marketCap` & `dailyChangePercent`.
- **Only reachable accounts.** Keep profiles that publish an email, a business
  email or a website. `emailDomains` keeps emails at the domains you list.
- **Narrow to your audience.** Filter by followers, posts, account age,
  verification, location, bio & username.
- **Pick up where you stopped.** Pass a saved cursor in `startCursor` to
  continue 1 query.

#### Complete results

- Each answer holds the fullest data X has for it.

#### Accurate rows

- Every ID in a row stays exact.
- 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 restarted run never charges twice.
- Runs stay within your spend cap & still write their diagnostics.

#### 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.
- Every run says why it ended & whether to retry.

#### 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) User Search Scraper extract?

- Each matching account's public profile, with name, bio, counts & verification.
- `sourceTarget`, the search term that found the profile.
- `email` & `contactInfo` with the emails, phones & links each profile
  publishes.
- `mode: "autocomplete"`, with the accounts, topics, hashtags & cashtags X
  suggests for each search term.

### How to search X users

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
profile, $5 pays for up to 33,000 profiles before platform usage. Then come back
here & press Try for free.

1. Open Xquik's X (Twitter) User Search Scraper in Apify Console.
2. Enter names, topics, bios or locations in `searchTerms`. Join alternatives
   with OR, as in `Nike OR Adidas`, to search each one.
3. Add filters such as `minFollowers`, `verifiedOnly` or `locationContains`.
4. Set `maxItems` to cap delivered profiles, then click Start.
5. Download the dataset as JSON, CSV or Excel, or use the Apify API.

### Input

```json
{
  "searchTerms": ["artificial intelligence", "machine learning"],
  "minFollowers": 1000,
  "maxItems": 10000
}
```

Small runs that go well skip `run-report` & save Apify usage. Turn on
`alwaysSaveRunRecords` to write it on every run.

#### Migrate from another user search Actor

Paste the input you already use. Xquik's X (Twitter) User Search Scraper reads
these field names of other Actors. Each line names their fields, then the field
they map to.

- `requireEmail`, `requireWebsite` map to `hasEmail`, `hasWebsite`.
- In `verification`, `any_verified` sets `verifiedOnly`, `blue_verified` sets
  `blueVerifiedOnly`, `business` & `government` set `verifiedType`. `unverified`
  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`.
- `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.

When you set one of these names & its canonical field, the canonical value wins.
The run log names the field that lost.

### Search autocomplete

Set `mode` to `autocomplete` to read what X suggests while someone types. Each
search term returns suggested accounts, topics, hashtags & cashtags.

```json
{
  "searchTerms": ["nasa", "$tsla"],
  "mode": "autocomplete",
  "suggestionTypes": ["users", "cashtags"],
  "maxItems": 100
}
```

- Start a term with `#` for hashtags or `$` for cashtags.
- `suggestionTypes` keeps only the types you choose.
- Each row names its `suggestionType` & the text to search in `suggestion`.
- A cashtag row carries `price`, `marketCap` & `dailyChangePercent`.
- Profile filters apply only to `mode: "search"`.

A suggestion row looks like this.

```json
{
  "suggestionType": "user",
  "suggestion": "@sample_user",
  "username": "sample_user",
  "name": "Sample User",
  "verified": true,
  "sourceTarget": "sample"
}
```

### Output

Each row holds a profile & its originating query in `sourceTarget`.

Examples use sample values. Results reflect live data. A profile row looks like
this.

```json
{
  "username": "sample_user",
  "name": "Sample User",
  "description": "Sample bio about artificial intelligence",
  "followers": 2500,
  "verified": false,
  "sourceTarget": "artificial intelligence"
}
```

### 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. 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.

### How much does it cost to search X users?

Every Apify plan costs $0.00015 per delivered profile. An autocomplete
suggestion costs the same per delivered row. Apify bills your platform usage
separately.

For more volume, [pick an Apify plan](https://apify.com/pricing?fpr=xquik) with
more prepaid usage.

- One charge per delivered data row. Diagnostics are free in `diagnostics`.
- No start, query or page fee.
- Filters & deduplication run before billing.

### Limits & recovery

Interrupted extraction writes a free `partial` diagnostic. Available results
stay intact. Read `availableResults`, `failedTargets`, `retryable` &
`nextAction` before you retry. A successful Actor exit confirms delivery, not
complete extraction.

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_failed`, `pagination_safety_limit` &
`deadline_reached`. A missing target joins the list only when another cause
stopped the run. The run is `retryable` when any cause is.

### 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) Profile Scraper](https://apify.com/xquik/x-profile-scraper)
  scrapes profiles plus their posts, replies, media & followers from handles,
  IDs or URLs. Use it when you start from accounts rather than searches. 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) 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) User Search Scraper needs no X account or X API key.

#### Is it legal to scrape X accounts?

Xquik's X (Twitter) User Search 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.

#### 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-user-search-scraper/api) has Python,
JavaScript & cURL examples. Apify
[schedules](https://docs.apify.com/platform/schedules) run Xquik's X (Twitter)
User Search Scraper on a cron. Agents use
[Apify MCP](https://docs.apify.com/platform/integrations/mcp). Use `latest`
unless you need an older build.

#### Where do I get help?

Open an issue in the
[Issues tab](https://apify.com/xquik/x-user-search-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.

#### Can I get a custom solution?

Yes. Describe what you need in the
[Issues tab](https://apify.com/xquik/x-user-search-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).

# Changelog

This Actor's version history is a separate document: https://apify.com/xquik/x-user-search-scraper/changelog.md

# Actor input Schema

## `searchTerms` (type: `array`):

Names, usernames, companies, topics, professions, or locations. X returns only profiles that match every word of a term. Join alternatives with OR, as in Nike OR Adidas, to search each one.

## `mode` (type: `string`):

Profile Search returns full profiles. Search Autocomplete returns the accounts, topics, hashtags & cashtags X suggests for each search term.

## `suggestionTypes` (type: `array`):

Search Autocomplete only. Choose which suggestions to return. All 4 run by default. Start a search term with # for hashtags or $ for cashtags.

## `maxItems` (type: `integer`):

Global delivered-profile cap across all queries. The form starts at 1,000. A run can return 100,000 rows & more, so raise it for a full export.

## `maxItemsPerTarget` (type: `integer`):

Optional delivered-profile cap for each query.

## `minFollowers` (type: `integer`):

Keep profiles with at least this many followers.

## `maxFollowers` (type: `integer`):

Keep profiles with no more than this many followers.

## `minFollowing` (type: `integer`):

Keep profiles following at least this many accounts.

## `maxFollowing` (type: `integer`):

Keep profiles following no more than this many accounts.

## `minStatuses` (type: `integer`):

Keep profiles with at least this many posts.

## `maxStatuses` (type: `integer`):

Keep profiles with no more than this many posts.

## `minAccountAgeDays` (type: `integer`):

Keep accounts at least this old.

## `verifiedOnly` (type: `boolean`):

Keep only profiles with an X verification badge.

## `blueVerifiedOnly` (type: `boolean`):

Keep only profiles X marks as blue verified. X marks many business & government accounts blue too.

## `verifiedType` (type: `string`):

Keep profiles with the selected verification type.

## `hasWebsite` (type: `boolean`):

Keep profiles that publish a website.

## `hasLocation` (type: `boolean`):

Keep profiles that publish 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 whose bio contains any of these words, ignoring case. Separate words with commas.

## `locationContains` (type: `string`):

Case-insensitive text required in the profile location.

## `usernameContains` (type: `string`):

Case-insensitive text required in the username.

## `startCursor` (type: `string`):

Continue one matching query from a saved cursor. Pass it unchanged.

## `dedupeAcrossTargets` (type: `boolean`):

Return each matching profile once across all queries.

## `maxConcurrency` (type: `integer`):

How many searches to run 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 contactInfo.emails. 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 contactInfoEmails. 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
{
  "searchTerms": [
    "artificial intelligence"
  ],
  "mode": "search",
  "suggestionTypes": [
    "users",
    "topics",
    "hashtags",
    "cashtags"
  ],
  "maxItems": 1000,
  "verifiedOnly": false,
  "blueVerifiedOnly": false,
  "hasWebsite": false,
  "hasLocation": false,
  "hasEmail": false,
  "businessEmailOnly": false,
  "emailDomains": "acme.com",
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "artificial intelligence"
    ],
    "maxItems": 1000
};

// Run the Actor and wait for it to finish
const run = await client.actor("xquik/x-user-search-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["artificial intelligence"],
    "maxItems": 1000,
}

# Run the Actor and wait for it to finish
run = client.actor("xquik/x-user-search-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 '{
  "searchTerms": [
    "artificial intelligence"
  ],
  "maxItems": 1000
}' |
apify call xquik/x-user-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,xquik/x-user-search-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 <APIFY_API_TOKEN>` 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/KD0TYftVytDfbh1bo/builds/yVuWRoqXotdwe91kC/openapi.json
