# X (Twitter) List Search Scraper & Finder (`arjun_code/x-twitter-list-search-scraper`) Actor

Find public X (Twitter) Lists for any topic or niche. Export List names, descriptions, member and subscriber counts, creation dates, and creator profiles. Filter results to uncover relevant communities for audience research, influencer discovery, and lead generation - no login or API key required.

- **URL**: https://apify.com/arjun\_code/x-twitter-list-search-scraper.md
- **Developed by:** [Arjun AI](https://apify.com/arjun_code) (community)
- **Categories:** Social media, Lead generation, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.38 / 1,000 list search results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/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

Find public **X / Twitter Lists** for any topic, industry, or niche. Enter keywords such as `AI`, `climate tech`, or `venture capital`, and the Actor saves matching Lists together with audience sizes and creator profiles.

Use it to discover curated communities without searching X manually. No X login, cookies, API key, or proxy setup is required.

### Why use this X List finder?

- Search up to 25 topics in one run.
- Save up to 1,000 matching Lists for each search.
- Compare List size, popularity, and creator reach.
- Filter out Lists that do not match your research goals.
- Export results as JSON, CSV, or Excel.
- Run manually, on a schedule, through the Apify API, or with integrations.

### How to search X Lists

1. Enter one or more topics in **Search keywords**.
2. Choose the maximum number of **Lists per search**.
3. Keep the default filters to collect every available result, or narrow the results by List size, subscribers, description, creator followers, or verification.
4. Click **Start** and open the Output tab when the run finishes.

The prefilled `AI` example is ready to run. Each keyword is searched separately, so a limit of 100 with two keywords can save up to 200 Lists.

### What data can you collect?

Each result contains useful information about the List and the account that created it.

#### List details

- List ID, name, description, creation date, and visibility.
- Number of members and subscribers.
- List banner image when available.
- The keyword that produced the result.

#### List creator profile

- User ID, username, display name, bio, location, and website.
- Followers, following, posts, media posts, and likes.
- Blue, Business, Government, and other verification signals returned by X.
- Avatar, profile banner, professional category, and affiliation details when available.

### Search and filter options

| Option | What it does |
| --- | --- |
| **Search keywords** | Enter up to 25 topics, one per line. Blank and repeated entries are ignored. |
| **Lists per search** | Save from 1 to 1,000 matching Lists for each keyword. |
| **Owner verification or badge** | Keep all creators, verified creators, Blue-verified creators, Business accounts, Government accounts, or unverified accounts. |
| **Minimum List members** | Keep Lists with at least this many members. |
| **Maximum List members** | Keep Lists with no more than this many members. Use 0 for no maximum. |
| **Minimum List subscribers** | Keep Lists followed by at least this many people. |
| **Only Lists with a description** | Exclude Lists with an empty description. |
| **Minimum owner followers** | Keep Lists created by accounts with at least this many followers. |

All selected filters work together. X may return fewer Lists than the requested maximum, especially for narrow searches or strict filters.

### Example input

```json
{
  "searchQueries": ["AI", "venture capital"],
  "maxListsPerQuery": 100,
  "minMembers": 50,
  "minSubscribers": 100,
  "onlyWithDescription": true,
  "ownerVerification": "any"
}
```

### Example result

```json
{
  "status": "success",
  "search_query": "AI",
  "list_id": "1585430245762441216",
  "list_name": "AI High Signal",
  "list_description": "AI twitter accounts that are high signal",
  "list_created_at": "2022-10-27T00:36:41Z",
  "list_visibility": "Public",
  "member_count": 623,
  "subscriber_count": 6900,
  "list_banner_url": "https://pbs.twimg.com/list_banner_img/1613505644405075970/9VRDCFnW?format=jpg&name=orig",
  "owner": {
    "user_id": "33521530",
    "screen_name": "swyx",
    "name": "swyx",
    "description": "achieve ambition with intentionality, intensity, integrity & insanity.\n\naffiliations:\n- @smol_ai\n- @dxtipshq\n- @cognition\n- @aidotengineer\n- @latentspacepod",
    "bio_urls": [],
    "bio_mentions": [],
    "bio_hashtags": [],
    "created_at": "2009-04-20T14:04:41Z",
    "location": "san francisco / singapore",
    "profile_description_language": "en",
    "profile_interstitial_type": null,
    "account_label": null,
    "followers_count": 195838,
    "following_count": 3927,
    "tweets_count": 78367,
    "media_count": 9241,
    "favourites_count": 135543,
    "is_blue_verified": true,
    "verified": false,
    "verified_type": null,
    "protected": false,
    "can_media_tag": true,
    "possibly_sensitive": false,
    "profile_image_url": "https://pbs.twimg.com/profile_images/2073162797354217472/hNny55eF_normal.jpg",
    "profile_banner_url": "https://pbs.twimg.com/profile_banners/33521530/1782712981",
    "website_url": "https://swyx.io",
    "pinned_tweet_id": "1281424520100737025",
    "professional_type": "Creator",
    "professional_categories": [
      "Psychic"
    ],
    "affiliation_name": "AI Engineer 🔜 NYC 🗽",
    "affiliation_type": "BusinessLabel",
    "affiliation_url": "https://twitter.com/aiDotEngineer",
    "affiliation_badge_url": "https://pbs.twimg.com/profile_images/2088074761607987200/25voc1vQ_bigger.jpg"
  }
}
```

Counts and profile details can change over time. Missing information is returned as `null` rather than being shown as zero.

### Popular use cases

- **Audience research:** discover curated communities around a market or niche.
- **Influencer discovery:** find Lists created by established or verified accounts.
- **Lead generation:** identify relevant communities and creators for further research.
- **Market mapping:** compare which Lists and curators appear across related topics.
- **Content discovery:** find focused Lists that can become useful reading sources.

### Use with AI assistants via MCP

You can search X Lists from ChatGPT, Claude, Cursor, or another MCP-compatible assistant using the Apify MCP server. Add this Actor-specific URL as a remote MCP server in your assistant:

```text
https://mcp.apify.com?tools=arjun_code/x-twitter-list-search-scraper
```

Sign in to your Apify account when prompted. In ChatGPT, add the URL under **Settings → Apps & Connectors → Create** and choose OAuth authentication. For other assistants, use their MCP server settings or the [Apify MCP configurator](https://mcp.apify.com/) for client-specific instructions.

Then try this prompt:

> Run `arjun_code/x-twitter-list-search-scraper` to find up to 50 public X Lists about AI agents. Keep Lists with at least 100 members. Read the results and show each List's name, member and subscriber counts, and owner username.

Runs started through MCP use the same [Actor pricing](#pricing) as runs started in Apify Console. See the [Apify MCP setup guide](https://docs.apify.com/integrations/mcp) for more connection options.

### Pricing

You pay only for the run start and Lists successfully saved to the Dataset.

| Charge | Price |
| --- | --- |
| Actor start at the default 512 MB memory | $0.00005 per run |
| Saved List on the Free plan | $0.00050 each |
| Saved List on Bronze | $0.00046 each |
| Saved List on Silver | $0.00042 each |
| Saved List on Gold or higher | $0.00038 each |

For example, 1,000 saved Lists cost $0.50 on the Free plan, plus the small start fee. Empty searches, invalid inputs, duplicate results, and status messages do not create a result charge. Use **Maximum cost per run** in Apify to set a spending limit. The Pricing tab is the current source of truth if prices change.

### Good to know

- Results reflect the public Lists X currently surfaces for each keyword; they are not a complete directory of every List on X.
- The same List may appear under different keywords so you can see which search produced it.
- Private or unavailable information cannot be collected.
- This Actor finds Lists and their creators. It does not download every member, subscriber, or post inside a List.
- If a search has no matches, the Output includes a clear message instead of failing the whole run.

To collect the members or subscribers of a discovered List, use [X / Twitter Lists Scraper](https://apify.com/arjun_code/x-twitter-lists-scraper).

This Actor is an independent tool and is not affiliated with or endorsed by X Corp.

# Actor input Schema

## `searchQueries` (type: `array`):

Enter up to 25 topics or keywords, one per line, for example AI or venture capital. Each line is searched separately. Blank lines are ignored, repeated identical searches run only once, and results follow X's List search order.

## `maxListsPerQuery` (type: `integer`):

Maximum number of unique Lists to save for each keyword search. Enter a whole number from 1 to 1,000. Default: 100. For example, two searches with a limit of 100 can save up to 200 results. X may return fewer matches.

## `ownerVerification` (type: `string`):

Filter by verification signals on the account that created the List. Blue, Business, and Government badges are separate signals and may overlap. Any verified or badged owner includes all available signals.

## `minMembers` (type: `integer`):

Only save Lists containing at least this many members. Keep 0 to allow any number of members.

## `maxMembers` (type: `integer`):

Only save Lists containing no more than this many members. Keep 0 to apply no maximum.

## `minSubscribers` (type: `integer`):

Only save Lists followed by at least this many subscribers. Subscribers follow the List; they are different from its members. Keep 0 to disable this filter.

## `onlyWithDescription` (type: `boolean`):

Enable this to exclude Lists whose description is empty.

## `minOwnerFollowers` (type: `integer`):

Only save Lists created by accounts with at least this many followers. Keep 0 to disable this filter.

## Actor input object example

```json
{
  "searchQueries": [
    "AI"
  ],
  "maxListsPerQuery": 100,
  "ownerVerification": "any",
  "minMembers": 0,
  "maxMembers": 0,
  "minSubscribers": 0,
  "onlyWithDescription": false,
  "minOwnerFollowers": 0
}
```

# Actor output Schema

## `results` (type: `string`):

Lists, owner profiles, and any search status messages.

# 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 = {
    "searchQueries": [
        "AI"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("arjun_code/x-twitter-list-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 = { "searchQueries": ["AI"] }

# Run the Actor and wait for it to finish
run = client.actor("arjun_code/x-twitter-list-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 '{
  "searchQueries": [
    "AI"
  ]
}' |
apify call arjun_code/x-twitter-list-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,arjun_code/x-twitter-list-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/QOwkX4YWVSM3nNXm8/builds/0c4amwBPFWShA7iCT/openapi.json