# X (Twitter) Follower Tracker | Unfollow Alerts | $0.0045/Hour (`xquik/x-twitter-follower-tracker`) Actor

Track new & lost followers of any X (Twitter) account, & whom it follows or unfollows. Each alert holds the other account's full profile. Get it in Telegram, Discord, Slack or a webhook at $0.0045 per monitor-hour. World's fastest & cheapest X (Twitter) scraper service. Not affiliated with X Corp.

- **URL**: https://apify.com/xquik/x-twitter-follower-tracker.md
- **Developed by:** [Xquik](https://apify.com/xquik) (community)
- **Categories:** Social media, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0045 / monitor hour

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-twitter-follower-tracker/README.es.md)
·
[Türkçe](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-twitter-follower-tracker/README.tr.md)
·
[简体中文](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-twitter-follower-tracker/README.zh-CN.md)
·
[日本語](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-twitter-follower-tracker/README.ja.md)
·
[한국어](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-twitter-follower-tracker/README.ko.md)
·
[Deutsch](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-twitter-follower-tracker/README.de.md)
·
[Français](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-twitter-follower-tracker/README.fr.md)
·
[Italiano](https://github.com/Xquik-dev/x-twitter-scraper/blob/master/apify/x-twitter-follower-tracker/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) Follower Tracker shows the new & lost
followers of the accounts you pick, & whom they follow or unfollow. Each alert
holds the other account's full profile. Most other Apify Actors charge before
filtering or deduplicating. Xquik charges only for delivered, unique results, &
here only for the hours a monitor watches.

Paste the accounts to track & click Start. Alerts arrive between runs. You pay
**$0.0045 per monitor-hour**. Events & alerts are free, & 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) Follower Tracker?

- **See who unfollowed you.** Each lost follower alert names the account, even
  one X suspended.
- **Track any public account.** Watch your own account, a competitor's or a
  client's.
- **No alerts for old followers.** The first run takes each list as it is. Only
  later changes alert you.
- **Alerts in your chat app.** Send them to Telegram, Discord or Slack. Telegram
  needs no chat ID. Any HTTPS webhook gets the full event too.
- **Know your alerts work.** Each new webhook, Slack or Discord URL gets a test
  alert. The run status says if it arrived.
- **Know the monitor is watching.** Each run's status page says so & shows 1
  next step with a button.
- **No silent pauses.** Your alerts warn you 4 hours before a monitor with no
  runs pauses. The next run resumes it.
- **No X account needed.** You never share your X login or an API key.

#### 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.
- Monitors report only real deletions & unfollows.

#### Fresh data

- Reads keep working when X ships changes.

#### Speed

- One slow page doesn't hold up your run.
- Stalled Actor calls recover on their own.

#### Fair billing

- Monitors have 1 flat hourly price, events & webhooks included.
- Monitor Actors bill only the hours a monitor watched.

#### Reliability

- A one-off error doesn't fail your run.
- Actors ride out short Xquik outages.
- Actor runs survive restarts without repeats.
- Stopped runs keep their rows & their report.
- A run that can't start still explains itself.
- Webhooks are signed & replay-safe.
- A webhook that was down still gets its events, for up to 7 days.
- New events arrive on time, even after your webhook was down.
- Webhooks never go to private or local hosts.
- Chat alerts arrive in order without hitting rate limits.
- 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.
- Actor READMEs, schemas & real output name the same fields.

### What data does X (Twitter) Follower Tracker send?

- New followers, the accounts that start following each account you watch.
- Lost followers, the accounts that leave its followers.
- New follows & unfollows, the accounts it starts or stops following.
- Each alert with the other account's full profile, such as its name, bio &
  follower count.
- Every event in the run's dataset & in 1 history dataset.

### How to track Twitter followers

Monitoring needs a paid Apify plan.
[Pick a plan](https://apify.com/pricing?fpr=xquik), then come back here & press
Try for free.

1. Open Xquik's X (Twitter) Follower Tracker in Apify Console.
2. Paste usernames into `twitterHandles`.
3. Turn on `telegram`, or paste a Discord or Slack webhook URL into
   `webhookUrls`.
4. Click Start. Tracking begins in that run.
5. Add a schedule that runs the Actor every hour, with the same input.

Each later run charges the hours watched since the run before & saves the new
events to its dataset. A monitor with no run for 24 hours pauses, & your alerts
warn you 4 hours before that. The next run resumes it & charges the unpaid hours
first.

### What the tracker sees

- New followers & new follows of any public account.
- Lost followers on accounts with up to 100,000 followers, & unfollows on
  accounts that follow up to 100,000. Above that, among the newest 5,000.
- A lost follower deep in a large list can arrive later than a new follower.
- A follower whose account X suspends or removes counts as lost too.
- An account that leaves & comes back can count as a new follower again.
- The first run takes each list as it is, so no existing follower counts as new.
- A protected account hides its lists, so it sends nothing.

### Input

| Field              | What it does                                                    |
| ------------------ | --------------------------------------------------------------- |
| `twitterHandles`   | Usernames with or without @, or `x.com` profile URLs, 1 a line. |
| `monitorName`      | Names this set of accounts, for runs without a saved task.      |
| `followerChanges`  | New & lost followers. On by default.                            |
| `followingChanges` | New follows & unfollows. On by default.                         |
| `webhookUrls`      | HTTPS URLs, 1 a line. Slack & Discord URLs are detected.        |
| `telegram`         | Sends alerts to Telegram through a link the run gives you.      |
| `stop`             | Stops the monitor & turns alerts off.                           |

1 input takes up to 100 accounts. Telegram needs no username or chat ID. The run
status gives a link. Open it & press Start, & alerts reach that chat. The form
hides the tweet events of X (Twitter) Monitor, & an input that sends them still
works.

These inputs are ready to copy.

```json
{ "twitterHandles": ["NASA"], "telegram": true }
```

```json
{
  "twitterHandles": ["yourhandle"],
  "followingChanges": false,
  "webhookUrls": "https://hooks.slack.com/services/T000/B000/XXXX"
}
```

### Output

Each run returns 4 outputs.

- **Status page**, the `STATUS.html` record. It shows if the monitor watches,
  the 1 next step with a button, what the run saved & charged, the targets &
  each alert destination. The Output tab shows it.
- **Status record**, the `STATUS` record. It holds the same status as JSON.
- **New events**, the run's dataset. It holds each new event, oldest first, & 1
  status row last.
- **Diagnostics**, written only when something needs attention.

An event row is the event exactly as Xquik's REST API serves it, with every
field. The status record holds `state`, `targets`, `destinations`,
`eventsSaved`, `hoursCharged`, `paidThrough`, `pausesAt`, `nextStep`,
`nextStepAction` & `nextStepUrl`, as X (Twitter) Follower Tracker shows them.

The history dataset in your account keeps every event of the monitor, each once.
Its name starts with `x-monitor-`.

### For AI agents

1 call is the whole API. Each call starts or updates the monitor, charges the
hours watched since the call before, & returns only what is new. No call charges
an hour twice. A call that starts or updates a monitor ends fast, inside what
Apify's MCP waits for. A stop takes about half a minute & saves the last events.

This input starts or continues a monitor.

```json
{ "twitterHandles": ["NASA"], "monitorName": "agent-demo" }
```

The run's dataset holds the new events, then 1 row with `resultType` `status`.
Its `state` says if the monitor watches, & `nextStep` says what to do next. To
check a monitor, call the Actor again with the same input. That changes nothing
& charges only hours already watched.

A monitor needs a run at least once every 24 hours to keep watching. Apify's MCP
server has no schedule tool, so you cannot add one. Ask the user to add an Apify
schedule on the page in `nextStepUrl`. It runs the Actor every hour with the
same input. Stop it with the same input & `"stop": true`.

### How much does a Twitter follower tracker cost?

Every paid Apify plan costs $0.0045 per monitor-hour. 1 account is 1 monitor.
Apify bills your platform usage separately.

- 1 account tracked for 30 days costs about $3.24.
- 10 accounts tracked for 30 days cost about $32.40.
- Events & alerts are free, however many arrive.
- No start fee. A run charges only hours already watched.
- A target X does not have watches nothing & costs nothing.
- Your maximum cost per run caps each charge. Hours past it wait for the next
  run.

An hourly schedule keeps Apify usage small next to the hours it pays. Runs every
few minutes add usage & change nothing for alerts, which arrive between runs
anyway.

Monitoring needs a [paid Apify plan](https://apify.com/pricing?fpr=xquik). On
the free plan, a run starts no monitor & charges nothing. It shows the 5 latest
tweets of your first account instead.

### Limits & recovery

- 1 input takes up to 100 accounts. Use 2 tasks for more.
- Up to 10 webhook URLs per input, plus Telegram.
- Events stay 30 days, so `since` can save them again within that time.
- A run that stops early leaves its events for the next run. None is lost.
- Each run writes 1 free status row, so its dataset is never empty.
- Every monitor Actor of Xquik charges the same hour price. A run pays the
  oldest unpaid hours of all your monitors, whichever Actor watched them.

### 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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) 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 X cookies, an API key or a login?

No. Xquik's X (Twitter) Follower Tracker needs no X cookies, API key, login or
credentials. Every check runs on Xquik's infrastructure.

#### Can I see who left my followers on X?

Yes. Watch your own public account. Each account that leaves its followers sends
a lost follower alert with its full profile. That includes an unfollow & an
account X suspends or removes.

#### Can it show whom an account follows?

Yes. `followingChanges` is on by default, so each account the watched account
starts or stops following sends an alert.

#### Does it work for accounts with millions of followers?

It names new followers of any public account. Lost followers are named on
accounts with up to 100,000 followers. Above that, among the newest 5,000.

#### Does it send tweets too?

No, by default. Turn on tweet events through `eventTypes`, or use X (Twitter)
Monitor for tweets.

#### Why does the run say monitoring needs a paid plan?

Monitors run between runs, all day. So they need a paid Apify plan. Upgrade,
then run again with the same input.

#### What happens when I stop the monitor?

The run stops every target & turns alerts off. It charges the hours watched
until then. It saves the newest events within about half a minute, so none is
lost. Events already kept stay readable for 30 days.

#### Can I use the API, schedules & integrations?

Yes. Use the Apify API or the Xquik REST API. The
[API tab](https://apify.com/xquik/x-twitter-follower-tracker/api) has Python,
JavaScript & cURL examples. Apify
[schedules](https://docs.apify.com/platform/schedules) keep the monitor running.
Agents use [Apify MCP](https://docs.apify.com/platform/integrations/mcp).

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

Xquik's X (Twitter) Follower Tracker requests public X data. Results can contain
personal data. Confirm a lawful purpose & follow the privacy rules that apply to
you. Ask qualified counsel when uncertain.

#### Where do I get help?

Open an issue in the
[Issues tab](https://apify.com/xquik/x-twitter-follower-tracker/issues) with the
run ID. The status page explains every run, & free diagnostics cover runs that
need attention.

#### Can I get a custom solution?

Yes. Describe what you need in the
[Issues tab](https://apify.com/xquik/x-twitter-follower-tracker/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-twitter-follower-tracker/changelog.md

# Actor input Schema

## `twitterHandles` (type: `array`):

Usernames with or without @, or x.com profile URLs, 1 a line. Each account is 1 monitor.

## `monitorName` (type: `string`):

Names this monitor for runs without a saved task. A run with the same name continues it. A saved task is its own monitor.

## `followerChanges` (type: `boolean`):

Accounts that start or stop following each watched account.

## `followingChanges` (type: `boolean`):

New follows & unfollows of each watched account.

## `webhookUrls` (type: `string`):

HTTPS URLs, 1 a line. Slack & Discord webhook URLs get their own message format. Other URLs get signed JSON. Each new URL gets a test alert.

## `telegram` (type: `boolean`):

Send alerts to Telegram. The run gives you a link. Open it & press Start.

## `stop` (type: `boolean`):

Stops every target & turns alerts off. The run charges the hours watched until now.

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

X searches, with any search operator, such as "x api" lang:en. Each search is 1 monitor & sends every new matching tweet.

## `newPosts` (type: `boolean`):

Every new tweet.

## `replies` (type: `boolean`):

Replies the accounts send or that match a keyword.

## `quotes` (type: `boolean`):

Quote tweets.

## `reposts` (type: `boolean`):

Reposts by the accounts.

## `deletedPosts` (type: `boolean`):

Tweets an account deletes.

## `liveVideos` (type: `boolean`):

A live video or Space an account starts.

## `profileChanges` (type: `boolean`):

Display name, username, bio, profile photo, banner, location, website, verification, protection, pinned tweet & availability.

## `eventTypes` (type: `array`):

The exact event types, which replace the checkboxes when set. They add tweets with mentions, hashtags, media, links, polls or long text.

## `since` (type: `string`):

A date in the last 30 days, such as 2026-10-01. The run saves the events kept since then, once.

## `alwaysSaveRunRecords` (type: `boolean`):

Save run-report on every run. When off, small runs that go well skip it & cost less.

## `handles` (type: `array`):

Another name for X Accounts, for inputs that use it.

## `usernames` (type: `array`):

Another name for X Accounts, for inputs that use it.

## `keywords` (type: `array`):

Another name for Keywords, for inputs that use it.

## `webhookUrl` (type: `string`):

Another name for 1 Webhook URL, for inputs that use it.

## `webhook` (type: `string`):

Another name for 1 Webhook URL, for inputs that use it.

## `slackWebhookUrl` (type: `string`):

Another name for 1 Webhook URL, for inputs that use it.

## `discordWebhookUrl` (type: `string`):

Another name for 1 Webhook URL, for inputs that use it.

## Actor input object example

```json
{
  "twitterHandles": [
    "NASA"
  ],
  "monitorName": "brand-mentions",
  "followerChanges": true,
  "followingChanges": true,
  "telegram": false,
  "stop": false,
  "searchTerms": [
    "xquik",
    "\"x api\" lang:en"
  ],
  "newPosts": false,
  "replies": false,
  "quotes": false,
  "reposts": false,
  "deletedPosts": false,
  "liveVideos": false,
  "profileChanges": false,
  "since": "2026-10-01",
  "alwaysSaveRunRecords": false
}
```

# Actor output Schema

## `statusPage` (type: `string`):

What the monitor watches, its alerts, its bill & the next step.

## `status` (type: `string`):

The same status as JSON, for agents & code.

## `events` (type: `string`):

Events since the run before, then 1 status row.

## `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 = {
    "twitterHandles": [
        "NASA"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("xquik/x-twitter-follower-tracker").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 = { "twitterHandles": ["NASA"] }

# Run the Actor and wait for it to finish
run = client.actor("xquik/x-twitter-follower-tracker").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": [
    "NASA"
  ]
}' |
apify call xquik/x-twitter-follower-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,xquik/x-twitter-follower-tracker"
        }
    }
}
```

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/aZiZlKjY6eRmlNxl6/builds/L5fCuuan2ZtGS7cFn/openapi.json
