# X.com (Twitter) Follower Scraper (`lurkapi/x-twitter-follower-scraper`) Actor

Scrape followers, following, verified followers, list members, and community members from any X.com profile. Full profile data per row with filters and sort.

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

## Pricing

from $0.10 / 1,000 follower scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## X.com (Twitter) Follower Scraper

Get the full list of followers, following, verified followers, or list members from any public X profile. Every row comes with rich profile data ready for lead lists, audience analysis, and CRM imports.

### 👥 What you get

The audience of any public X account, packaged for outreach. One row per follower with everything you need to qualify, filter, and contact:

- **Contact surface**: bio, website, location, avatar, banner
- **Reach**: follower, following, tweet, media, and likes counts
- **Trust**: verified badge type (Blue, Business, Government, Legacy)
- **Identity**: numeric user ID, join date, private-account flag

All extracted from public X profile data. Nothing behind login.

### 📋 How to use it

#### Step 1: Add targets

Drop in one or more X handles like `elonmusk` or `apify`. Also accepted:

- **Numeric user IDs** like `44196397`. Survives handle changes.
- **Full URLs**. The relation is picked up from the path:

| URL pattern                       | Relation           |
|-----------------------------------|--------------------|
| `x.com/<user>/followers`          | Followers          |
| `x.com/<user>/following`          | Following          |
| `x.com/<user>/verified_followers` | Verified Followers |
| `x.com/i/lists/<id>/members`      | List Members       |

Bare handles and user IDs use the **Relation** dropdown (default: Followers). Cap total volume with `Max followers per run` and `Max followers per target`.

#### Step 2: Filter and sort

Every filtered row is FREE. Stack any of:

- **Size**: min or max followers, following, or account age.
- **Verification**: verified only, verified type (Blue, Business, Government, Legacy).
- **Keywords**: bio, location, or username contains.
- **Presence**: has website, has location, has bio.

**Sort** the survivors by follower count, following count, tweet count, or join date. Ascending or descending.

#### Step 3: Run and export

Click **Start**. Rows stream into the **Output** tab as they scrape, no need to wait for the whole run. Grab the dataset from Apify Console in JSON, CSV, Excel, or HTML, or pull it over the API.

Every row carries a `status` field. `Success` = real follower. Anything else names the problem (target private, target not found, unsupported relation) so you know what to fix or skip.

### ✨ Add-ons

**📧 Extract emails**

Scans each follower's bio and their linked website for a valid email address. Charged only when an email is actually found. Failed scans are free. Adds an `email` field to matching rows.

### 💰 Pricing

Pay per row. Filtered, duplicated, and failed rows are always free.

| Event                | Per 1,000  |
|----------------------|-----------:|
| Follower scraped     | **$0.10**  |
| Email found (add-on) | **$10.00** |

Real-world math:

- **1,000 followers**: $0.10
- **10,000 followers**: $1.00
- **1,000 followers + email add-on at 10% hit rate**: $0.10 + $1.00 = **$1.10**
- **10,000 followers + email add-on at 10% hit rate**: $1.00 + $10.00 = **$11.00**

### 💡 Good to know

- **Cross-target dedup**: the same follower surfacing under multiple targets in one run is charged once.
- **Field toggles**: every output field has its own on/off switch to keep rows lean for CSV or Sheets.
- **Resume long jobs**: `Skip first N` picks up where the last run stopped, no re-billing on already-scraped rows.
- **Mixed input**: pass handles, numeric IDs, and URLs in the same run.
- **Community members**: login-only on X's side, not supported yet.
- **Storage**: rows land in your Apify account. Retention depends on your plan.

### ❓ FAQ

**Why did my target return zero rows?**

The account is protected (private) or was suspended. Private follower lists are hidden from every tool. For public accounts, drop `Max followers per run` and re-run in a few minutes.

**Can I resume a huge run without paying twice?**

Yes. Set `Skip first N` to the count you already have (e.g. `20000`) and re-run the same target. Skipped rows are free; scraping picks up at row N+1.

**Which sort should I use?**

Default = newest follow first, matching what X shows on the profile. Switch to `followers` descending to surface the biggest accounts inside a target's audience.

**Do filters cost anything?**

No. Filtered rows never bill. You only pay for rows that pass every filter and reach your dataset.

**Can I scrape a private / protected account?**

No. If X hides it, no scraper can see it.

**Can I scrape verified followers only?**

Yes, two ways: pass a `/verified_followers` URL, or scrape Followers with `Verified only` toggled on plus (optionally) a `Verified type` filter.

**How do I export to Google Sheets / Excel / a CRM?**

From the run's Output tab, hit Export → CSV, Excel, JSON, or HTML. Or pull via the Apify API for a live pipeline.

**How long are results kept?**

Rows live in your Apify account. Retention length depends on your Apify plan.

### 🔗 Other tools you might like

- [X.com (Twitter) Profile Scraper](https://apify.com/lurkapi/x-twitter-profile-scraper) - Tweets from any X profile with filters and add-ons.
- [X.com (Twitter) Tweet Scraper](https://apify.com/lurkapi/x-twitter-tweet-scraper) - Any tweet by URL, ID, or search query.
- [X.com (Twitter) Tweet Replies Scraper](https://apify.com/lurkapi/x-twitter-tweet-replies-scraper) - Full reply tree from any tweet URL.
- [X.com (Twitter) Video, Photo & GIF Downloader](https://apify.com/lurkapi/x-twitter-video-photo-gif-downloader) - Download every media file from a tweet, handle, or search.

### ⚖️ Disclaimer

Intended for personal, research, and educational use. You are responsible for complying with X's Terms of Service and applicable laws in your jurisdiction. The developer is not liable for misuse. Data availability depends on X at run time.

**Keywords:** x scraper, twitter scraper, follower scraper, twitter followers, x followers, twitter following, follower list, twitter audience, lead generation, x lead gen

# Actor input Schema

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

Usernames (e.g. elonmusk) or full profile URLs (https://x.com/elonmusk). One entry per target.
## `userIds` (type: `array`):

Numeric X user IDs (e.g. 44196397). Useful when a handle has changed.
## `urls` (type: `array`):

Full X URLs. Relation auto-detected from path suffix (/followers, /following, /verified_followers, /i/lists/.../members). Bare profile URLs use the Relation dropdown.
## `relation` (type: `string`):

What to scrape for each target. Ignored when a URL already says (e.g. /followers).
## `maxItems` (type: `integer`):

Hard cap on total rows returned across all targets. Default 100.
## `maxItemsPerTarget` (type: `integer`):

Hard cap per target. Default 100.
## `skipFirst` (type: `integer`):

Skip the first N followers X returns (per target). Use to resume where a prior run stopped without re-paying for already-scraped rows. Applied BEFORE filters. Default 0.
## `sortBy` (type: `string`):

Default = newest follow first. Other options sort the results.
## `sortOrder` (type: `string`):

Ignored when Sort = Default.
## `minFollowers` (type: `integer`):

Drop rows below this follower count. Filtered rows are FREE (not billed).
## `maxFollowers` (type: `integer`):

Drop rows above this follower count.
## `minFollowing` (type: `integer`):

Drop rows below this following count.
## `maxFollowing` (type: `integer`):

Drop rows above this following count.
## `verifiedOnly` (type: `boolean`):

Keep only verified accounts (blue-check or legacy).
## `verifiedType` (type: `string`):

Restrict to a specific verification type. Ignored when Verified only is off.
## `minAccountAgeDays` (type: `integer`):

Drop accounts newer than this many days. Useful to filter out bots.
## `bioContains` (type: `string`):

Keep rows whose bio contains this text.
## `locationContains` (type: `string`):

Keep rows whose location contains this text.
## `usernameContains` (type: `string`):

Keep rows whose @handle contains this text.
## `hasWebsite` (type: `boolean`):

Keep only accounts that have a website link in their profile.
## `hasLocation` (type: `boolean`):

Keep only accounts with a self-set location.
## `hasBio` (type: `boolean`):

Keep only accounts with a non-empty bio.
## `extractEmails` (type: `boolean`):

Scan each follower's bio and website for an email address. Charged only when an email is actually found. Failed lookups are free. Adds an `email` field to the row on success.
## `outputId` (type: `boolean`):

Numeric X user ID.
## `outputUsername` (type: `boolean`):

@ handle.
## `outputName` (type: `boolean`):

Display name.
## `outputBio` (type: `boolean`):

Profile bio / description.
## `outputUrl` (type: `boolean`):

Canonical profile URL.
## `outputFollowers` (type: `boolean`):

Follower count.
## `outputFollowing` (type: `boolean`):

Following count.
## `outputTweetCount` (type: `boolean`):

Total tweet count.
## `outputMediaCount` (type: `boolean`):

Media tweet count.
## `outputLikesCount` (type: `boolean`):

Favourite (likes given) count.
## `outputVerified` (type: `boolean`):

Boolean verified flag (blue-check or legacy).
## `outputVerifiedType` (type: `boolean`):

Verification type (Blue / Business / Government / null).
## `outputLocation` (type: `boolean`):

Self-set location string.
## `outputWebsite` (type: `boolean`):

Website URL.
## `outputProfileImageUrl` (type: `boolean`):

Avatar image URL (full-size, un-cropped).
## `outputBannerUrl` (type: `boolean`):

Header/banner image URL.
## `outputCreatedAt` (type: `boolean`):

ISO-8601 account creation date.
## `outputProtected` (type: `boolean`):

Boolean: whether the account is private/protected.
## `outputCanDm` (type: `boolean`):

Boolean: whether the account can receive DMs from you.
## `outputEmail` (type: `boolean`):

Email field. Only present when Extract emails add-on is enabled AND an email was found.

## Actor input object example

```json
{
  "handles": [
    "elonmusk"
  ],
  "userIds": [],
  "urls": [],
  "relation": "Followers",
  "maxItems": 20,
  "maxItemsPerTarget": 20,
  "skipFirst": 0,
  "sortBy": "Default",
  "sortOrder": "desc",
  "verifiedOnly": false,
  "verifiedType": "",
  "hasWebsite": false,
  "hasLocation": false,
  "hasBio": false,
  "extractEmails": false,
  "outputId": true,
  "outputUsername": true,
  "outputName": true,
  "outputBio": true,
  "outputUrl": true,
  "outputFollowers": true,
  "outputFollowing": true,
  "outputTweetCount": true,
  "outputMediaCount": true,
  "outputLikesCount": true,
  "outputVerified": true,
  "outputVerifiedType": true,
  "outputLocation": true,
  "outputWebsite": true,
  "outputProfileImageUrl": true,
  "outputBannerUrl": true,
  "outputCreatedAt": true,
  "outputProtected": true,
  "outputCanDm": true,
  "outputEmail": true
}
````

# Actor output Schema

## `overview` (type: `string`):

Compact table with the essentials.

## `profiles` (type: `string`):

Full profile fields per row.

## `contacts` (type: `string`):

Email / website / location focused view (populated when the Extract emails add-on is on).

# 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 = {
    "handles": [
        "elonmusk"
    ],
    "userIds": [],
    "urls": [],
    "maxItems": 20,
    "maxItemsPerTarget": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("lurkapi/x-twitter-follower-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 = {
    "handles": ["elonmusk"],
    "userIds": [],
    "urls": [],
    "maxItems": 20,
    "maxItemsPerTarget": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("lurkapi/x-twitter-follower-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "handles": [
    "elonmusk"
  ],
  "userIds": [],
  "urls": [],
  "maxItems": 20,
  "maxItemsPerTarget": 20
}' |
apify call lurkapi/x-twitter-follower-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lurkapi/x-twitter-follower-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "X.com (Twitter) Follower Scraper",
        "description": "Scrape followers, following, verified followers, list members, and community members from any X.com profile. Full profile data per row with filters and sort.",
        "version": "0.0",
        "x-build-id": "s51NenkAPQInjqi0N"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/lurkapi~x-twitter-follower-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-lurkapi-x-twitter-follower-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/lurkapi~x-twitter-follower-scraper/runs": {
            "post": {
                "operationId": "runs-sync-lurkapi-x-twitter-follower-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/lurkapi~x-twitter-follower-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-lurkapi-x-twitter-follower-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "handles": {
                        "title": "👤 X handles",
                        "type": "array",
                        "description": "Usernames (e.g. elonmusk) or full profile URLs (https://x.com/elonmusk). One entry per target.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "userIds": {
                        "title": "🔢 Numeric user IDs",
                        "type": "array",
                        "description": "Numeric X user IDs (e.g. 44196397). Useful when a handle has changed.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "urls": {
                        "title": "🔗 Full URLs",
                        "type": "array",
                        "description": "Full X URLs. Relation auto-detected from path suffix (/followers, /following, /verified_followers, /i/lists/.../members). Bare profile URLs use the Relation dropdown.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "relation": {
                        "title": "Relation",
                        "enum": [
                            "Followers",
                            "Following",
                            "Verified Followers",
                            "List Members",
                            "Community Members"
                        ],
                        "type": "string",
                        "description": "What to scrape for each target. Ignored when a URL already says (e.g. /followers).",
                        "default": "Followers"
                    },
                    "maxItems": {
                        "title": "Max followers per run",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Hard cap on total rows returned across all targets. Default 100.",
                        "default": 100
                    },
                    "maxItemsPerTarget": {
                        "title": "Max followers per target",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Hard cap per target. Default 100.",
                        "default": 100
                    },
                    "skipFirst": {
                        "title": "Skip first N",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Skip the first N followers X returns (per target). Use to resume where a prior run stopped without re-paying for already-scraped rows. Applied BEFORE filters. Default 0.",
                        "default": 0
                    },
                    "sortBy": {
                        "title": "Sort",
                        "enum": [
                            "Default",
                            "followers",
                            "following",
                            "tweetCount",
                            "createdAt"
                        ],
                        "type": "string",
                        "description": "Default = newest follow first. Other options sort the results.",
                        "default": "Default"
                    },
                    "sortOrder": {
                        "title": "Sort order",
                        "enum": [
                            "desc",
                            "asc"
                        ],
                        "type": "string",
                        "description": "Ignored when Sort = Default.",
                        "default": "desc"
                    },
                    "minFollowers": {
                        "title": "Minimum followers",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop rows below this follower count. Filtered rows are FREE (not billed)."
                    },
                    "maxFollowers": {
                        "title": "Maximum followers",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop rows above this follower count."
                    },
                    "minFollowing": {
                        "title": "Minimum following",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop rows below this following count."
                    },
                    "maxFollowing": {
                        "title": "Maximum following",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop rows above this following count."
                    },
                    "verifiedOnly": {
                        "title": "Verified only",
                        "type": "boolean",
                        "description": "Keep only verified accounts (blue-check or legacy).",
                        "default": false
                    },
                    "verifiedType": {
                        "title": "Verified type",
                        "enum": [
                            "",
                            "Blue",
                            "Business",
                            "Government"
                        ],
                        "type": "string",
                        "description": "Restrict to a specific verification type. Ignored when Verified only is off.",
                        "default": ""
                    },
                    "minAccountAgeDays": {
                        "title": "Minimum account age (days)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop accounts newer than this many days. Useful to filter out bots."
                    },
                    "bioContains": {
                        "title": "Bio contains",
                        "type": "string",
                        "description": "Keep rows whose bio contains this text."
                    },
                    "locationContains": {
                        "title": "Location contains",
                        "type": "string",
                        "description": "Keep rows whose location contains this text."
                    },
                    "usernameContains": {
                        "title": "Username contains",
                        "type": "string",
                        "description": "Keep rows whose @handle contains this text."
                    },
                    "hasWebsite": {
                        "title": "Has website",
                        "type": "boolean",
                        "description": "Keep only accounts that have a website link in their profile.",
                        "default": false
                    },
                    "hasLocation": {
                        "title": "Has location",
                        "type": "boolean",
                        "description": "Keep only accounts with a self-set location.",
                        "default": false
                    },
                    "hasBio": {
                        "title": "Has bio",
                        "type": "boolean",
                        "description": "Keep only accounts with a non-empty bio.",
                        "default": false
                    },
                    "extractEmails": {
                        "title": "Extract emails ($)",
                        "type": "boolean",
                        "description": "Scan each follower's bio and website for an email address. Charged only when an email is actually found. Failed lookups are free. Adds an `email` field to the row on success.",
                        "default": false
                    },
                    "outputId": {
                        "title": "id",
                        "type": "boolean",
                        "description": "Numeric X user ID.",
                        "default": true
                    },
                    "outputUsername": {
                        "title": "username",
                        "type": "boolean",
                        "description": "@ handle.",
                        "default": true
                    },
                    "outputName": {
                        "title": "name",
                        "type": "boolean",
                        "description": "Display name.",
                        "default": true
                    },
                    "outputBio": {
                        "title": "bio",
                        "type": "boolean",
                        "description": "Profile bio / description.",
                        "default": true
                    },
                    "outputUrl": {
                        "title": "url",
                        "type": "boolean",
                        "description": "Canonical profile URL.",
                        "default": true
                    },
                    "outputFollowers": {
                        "title": "followers",
                        "type": "boolean",
                        "description": "Follower count.",
                        "default": true
                    },
                    "outputFollowing": {
                        "title": "following",
                        "type": "boolean",
                        "description": "Following count.",
                        "default": true
                    },
                    "outputTweetCount": {
                        "title": "tweetCount",
                        "type": "boolean",
                        "description": "Total tweet count.",
                        "default": true
                    },
                    "outputMediaCount": {
                        "title": "mediaCount",
                        "type": "boolean",
                        "description": "Media tweet count.",
                        "default": true
                    },
                    "outputLikesCount": {
                        "title": "likesCount",
                        "type": "boolean",
                        "description": "Favourite (likes given) count.",
                        "default": true
                    },
                    "outputVerified": {
                        "title": "verified",
                        "type": "boolean",
                        "description": "Boolean verified flag (blue-check or legacy).",
                        "default": true
                    },
                    "outputVerifiedType": {
                        "title": "verifiedType",
                        "type": "boolean",
                        "description": "Verification type (Blue / Business / Government / null).",
                        "default": true
                    },
                    "outputLocation": {
                        "title": "location",
                        "type": "boolean",
                        "description": "Self-set location string.",
                        "default": true
                    },
                    "outputWebsite": {
                        "title": "website",
                        "type": "boolean",
                        "description": "Website URL.",
                        "default": true
                    },
                    "outputProfileImageUrl": {
                        "title": "profileImageUrl",
                        "type": "boolean",
                        "description": "Avatar image URL (full-size, un-cropped).",
                        "default": true
                    },
                    "outputBannerUrl": {
                        "title": "bannerUrl",
                        "type": "boolean",
                        "description": "Header/banner image URL.",
                        "default": true
                    },
                    "outputCreatedAt": {
                        "title": "createdAt",
                        "type": "boolean",
                        "description": "ISO-8601 account creation date.",
                        "default": true
                    },
                    "outputProtected": {
                        "title": "protected",
                        "type": "boolean",
                        "description": "Boolean: whether the account is private/protected.",
                        "default": true
                    },
                    "outputCanDm": {
                        "title": "canDm",
                        "type": "boolean",
                        "description": "Boolean: whether the account can receive DMs from you.",
                        "default": true
                    },
                    "outputEmail": {
                        "title": "email",
                        "type": "boolean",
                        "description": "Email field. Only present when Extract emails add-on is enabled AND an email was found.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
