# WhatsApp Channel Search Scraper - Followers & Top Lists (`vero-api/whatsapp-channel-search-scraper`) Actor

Find WhatsApp channels by keyword, or get the most popular, trending and newest channels of any country and category. Each channel comes with its name, exact follower count, description, verified badge, creation date, picture and link. Look up channel links in bulk too. No WhatsApp account needed.

- **URL**: https://apify.com/vero-api/whatsapp-channel-search-scraper.md
- **Developed by:** [VeroAPIs](https://apify.com/vero-api) (community)
- **Categories:** Social media, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 94.4% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.20 / 1,000 channels

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

## WhatsApp Channel Search Scraper — find channels by keyword, exact follower counts, and top lists by country

Find WhatsApp channels by keyword and get every channel as clean, structured data: name, exact follower count, description, verified badge, creation date, picture, and link. Get WhatsApp's top lists (most popular, trending, newest, featured) for any country and category, or look up channel links in bulk. No WhatsApp account, no phone number, no setup.

Looking for what a channel posts? [WhatsApp Channel Posts Scraper](https://apify.com/vero-api/whatsapp-channel-posts-scraper) returns the posts themselves, with reactions, polls, and media. This actor finds the channels and tells you everything about them.

### What is WhatsApp Channel Search Scraper?

WhatsApp Channel Search Scraper is an unofficial WhatsApp channel search API. It returns the same channels and rankings you see in the Channels tab of the WhatsApp app, each as a row you can download as JSON, CSV, or Excel, or read straight from your code. Use it as a:

- **WhatsApp channel search tool** — find channels by keyword, exactly like the search box in the app.
- **WhatsApp channel finder** — discover the top channels of any country, by category.
- **WhatsApp channel follower counter** — exact follower counts (`233,950,438`, not "233M"), ready to track over time.
- **WhatsApp channel link checker** — turn a list of channel links into full profiles, and spot the links that no longer work.
- **WhatsApp channel directory export** — WhatsApp's channel rankings in a spreadsheet, with each channel's position.

### What you can do

- Search channels by any keyword, in any language: `football`, `crypto news`, `recetas`, `أخبار`
- Get WhatsApp's own rankings: most popular, trending, newest, featured, and recommended channels
- Pick any of 250 countries, and get each country's list side by side
- Narrow to a category: Business, Entertainment, Lifestyle, News & Information, Organizations, People, Sports
- Look up channel links in bulk and get the full profile of each
- Keep only verified channels, or only channels above a follower count
- Run it on a schedule to track follower growth and ranking changes

### Why use it

- **The real directory.** You get the same channels and rankings WhatsApp shows in its Channels tab, in the same order.
- **Exact numbers.** Follower counts to the last digit, plus the date each channel was created.
- **Rankings you can't get elsewhere.** Every row from a search or top list carries its position, so you can see who ranks first and track it over time.
- **Fast.** A keyword search or a full 500-channel top list comes back in about a second.
- **Deep top lists.** Up to 500 channels per country, per list, per category.
- **Filters that save money.** Minimum followers and verified-only are applied before delivery, and you pay only for the channels that match.
- **No login, ever.** Nothing to sign in to, no phone number, no API keys.

### Use cases

- **Influencer and partnership research** — find the biggest channels in your niche and country before you pitch or advertise.
- **Competitor and market research** — size a topic by follower counts, and see which brands already run channels.
- **Lead generation** — build lists of channels by keyword, with descriptions that often carry contact details and websites.
- **Media monitoring** — find the news channels of any country, ranked by audience.
- **Growth tracking** — schedule daily runs on your own and your competitors' channel links, and chart follower counts over time.
- **Brand protection** — search your brand name and see every channel using it, verified or not.
- **AI and LLM pipelines** — give your agent a live, structured view of WhatsApp Channels.

### What WhatsApp channel data can you extract?

| Channel | Ranking |
|---|---|
| Name | How it was found: search, top list, or link |
| Full description | The search term that found it |
| Exact follower count | The top list it is on |
| Verified badge | The list's country |
| Creation date | The category |
| Username, when the channel has one | Position in WhatsApp's own ranking |
| Picture | |
| Channel link and invite code | |
| Permanent channel ID | |

### How to use it

1. Add one or more **search terms**, paste **channel links**, or pick a **top list**. You can combine all three in one run.
2. Optionally pick **countries** and **categories**, and set a minimum follower count.
3. Click **Start**.
4. Download your results as JSON, CSV, or Excel.

### Input example

Search two keywords and keep only the bigger channels:

```json
{
  "searchQueries": ["football", "crypto news"],
  "minFollowers": 10000
}
```

Get the most popular sports channels in Brazil and India:

```json
{
  "topList": "popular",
  "countries": ["BR", "IN"],
  "categories": ["sports"],
  "maxChannels": 500
}
```

Look up channels you already know:

```json
{
  "channels": [
    "https://whatsapp.com/channel/0029Va4K0PZ5a245NkngBA2M",
    "https://whatsapp.com/channel/0029VaIzCUb2Jl8CEWrxj912"
  ]
}
```

| Field | What it does |
|---|---|
| **Search terms** | Keywords to search, one per line. Each search returns the channels WhatsApp's own search shows for it, usually 45 to 60. Add more terms to cover a topic from every angle. |
| **Channel links** | Links like `https://whatsapp.com/channel/0029Va4K0PZ5a245NkngBA2M`, or just the code at the end. |
| **Top list** | Most popular, Trending, Newest, Featured, or Recommended. Each list holds up to 500 channels per country (Recommended: about 250). |
| **Countries** | The countries whose top lists you want. Each country is its own list. Defaults to the United States. |
| **Categories** | Narrow searches and top lists to one or more categories. Each category is read on its own, so every row says which category it came from. |
| **Max channels per search** | How many channels you want from each search term and each top list. |
| **Minimum followers** | Only channels with at least this many followers. |
| **Verified channels only** | Only channels with WhatsApp's green verified badge. |

### What you get

One row per channel. This is a real row from the most popular sports channels in Brazil:

```json
{
  "url": "https://whatsapp.com/channel/0029VZzjvDWIt5s5EgORWP0q",
  "name": "Real Madrid C.F.",
  "description": "¡Bienvenidos al canal oficial del Real Madrid!\nWelcome to the official Real Madrid channel!",
  "followers": 60297408,
  "verified": true,
  "createdAt": "2023-06-06T09:11:21.000Z",
  "username": null,
  "pictureUrl": "https://pps.whatsapp.net/m1/v/t24/AQOrLw9f04euQfaLxJp3GIIeXfySJkTBw4…",
  "channelId": "120363159552753674@newsletter",
  "inviteCode": "0029VZzjvDWIt5s5EgORWP0q",
  "source": "topList",
  "topList": "popular",
  "country": "BR",
  "category": "sports",
  "position": 1,
  "scrapedAt": "2026-11-11T14:25:02.525Z"
}
```

A search for `football` returns rows like these, in WhatsApp's own order:

| position | name | followers | verified | createdAt |
|---|---|---|---|---|
| 1 | Football | 4,019,017 | ✅ | 2025-10-11 |
| 2 | OneFootball | 1,398,321 | ✅ | 2023-09-25 |
| 3 | Kaizer Chiefs Football Club | 2,503,868 | ✅ | 2023-09-27 |
| 4 | Football HD Wallpapers ⚽ | 9,640 | | 2026-03-27 |
| 5 | BBC Football | 1,426,884 | ✅ | 2024-02-05 |
| 6 | Liverpool Football Club | 16,944,118 | ✅ | 2023-07-15 |

| Field | What it is |
|---|---|
| `url` | Link that opens the channel on WhatsApp. |
| `name`, `description` | The channel's name and full description. |
| `followers` | Exact follower count. |
| `verified` | `true` for channels with the green verified badge. |
| `createdAt` | When the channel was created. |
| `username` | The channel's username, when it has one. |
| `pictureUrl` | Link to the channel's picture. Save the image if you need it long term. |
| `channelId` | WhatsApp's permanent ID for the channel. It never changes, so use it to match rows across runs. |
| `inviteCode` | The code at the end of the channel link. |
| `source` | `search`, `topList`, or `link`. |
| `searchQuery`, `topList`, `country`, `category` | What found the channel. |
| `position` | The channel's place in WhatsApp's ranking for that search or list. |

### Pricing

You pay only for the channels you get — no subscriptions, no surprises. Filters are free: channels that don't match your minimum followers or verified-only setting are never charged. Set a spending limit and the run stops exactly there.

### Integrations

Send channels anywhere with Apify's built-in integrations: Google Sheets, Slack, Zapier, Make, n8n, Airbyte, webhooks, and more. Schedule a daily run on your channel links and follower counts land in your spreadsheet automatically, ready to chart.

### Run it from your code or AI assistant

Call it from JavaScript with the Apify client:

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('vero-api/whatsapp-channel-search-scraper').call({
  searchQueries: ['football'],
  minFollowers: 10000,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, 'channels');
```

Or from Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("vero-api/whatsapp-channel-search-scraper").call(run_input={
    "topList": "popular",
    "countries": ["BR"],
    "categories": ["sports"],
})
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item["position"], item["name"], item["followers"])
```

AI assistants such as Claude and ChatGPT can run it too, through the Apify MCP server: ask for "the most popular WhatsApp channels in Brazil" and the assistant runs the actor for you.

### FAQ

**Do I need a WhatsApp account or phone number?** No. Add a search term and start.

**How many channels does a search return?** The same channels WhatsApp's own search shows for that keyword, usually 45 to 60, best matches first. For broad coverage of a topic, add several related terms (`football`, `soccer`, `premier league`, `futebol`): a channel found by more than one term is delivered once.

**How big are the top lists?** Up to 500 channels per country for Most popular, Trending, Newest, and Featured, and about 250 for Recommended. Add categories to get a separate list of up to 500 for each one. Set **Max channels per search** to 500 to get them in full.

**Are follower counts exact?** Yes. You get the full number, such as `60297408`, not a rounded "60M".

**Can I search in other languages?** Yes. Search terms work in any language and script.

**Can I filter search by country?** Top lists are per country. Search covers all countries at once, so add the country or language to your search term to focus it, for example `noticias argentina`.

**The same channel is on several of my top lists. Do I get it once?** Each top list is delivered in full, with the channel's position in that list, so you can compare countries and categories. Channels found by search terms are delivered once per run.

**What if a link doesn't work anymore?** The run keeps going, and you get one row for that link saying the channel no longer exists, billed like one channel.

**Can I track a channel's growth?** Yes. Schedule the actor with your channel links and compare `followers` between runs. Use `channelId` to match rows: it stays the same even when a channel is renamed.

**Does it get channel posts?** This actor finds channels and their profiles. For the posts themselves, with reactions, polls, and media, feed its links to [WhatsApp Channel Posts Scraper](https://apify.com/vero-api/whatsapp-channel-posts-scraper).

**Can it get phone numbers or follower lists?** No. WhatsApp keeps channel admins and followers private, and so does this actor.

**Can I call it like an API?** Yes — start a run through the Apify API and read the channels from its dataset.

**How fresh is the data?** Every run reads WhatsApp live, so counts and rankings are current to the second.

**Is this an official WhatsApp tool?** No. WhatsApp Channel Search Scraper is an independent tool. It is not affiliated with, endorsed by, or sponsored by WhatsApp or Meta.

### More tools from us

- [WhatsApp Channel Posts Scraper](https://apify.com/vero-api/whatsapp-channel-posts-scraper) — the posts of any channel, with reactions, polls, and media links.
- [WhatsApp Number Checker](https://apify.com/vero-api/whatsapp-number-checker) — check which phone numbers are on WhatsApp, in bulk.
- [Telegram Channel Scraper](https://apify.com/vero-api/telegram-channel-scraper) — posts, views, reactions, and media from public Telegram channels.
- [Telegram Username Checker](https://apify.com/vero-api/telegram-username-checker) — profiles, channels, groups, and bots by username.
- [Threads Scraper](https://apify.com/vero-api/threads-scraper) — posts, profiles, hashtags, and replies from Meta Threads.
- [Instagram Posts Scraper](https://apify.com/vero-api/instagram-posts-scraper) — posts, captions, and engagement from Instagram.

# Actor input Schema

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

Find channels by keyword, exactly like the search box in WhatsApp's Channels tab. One search per line, e.g. <code>football</code>, <code>crypto news</code> or <code>recetas</code>.

## `channels` (type: `array`):

Get the details of channels you already know. Paste channel links, e.g. <code>https://whatsapp.com/channel/0029Va4K0PZ5a245NkngBA2M</code>.

## `topList` (type: `string`):

Get one of WhatsApp's own channel rankings. Combine it with <b>Countries</b> and <b>Categories</b> to get, for example, the most popular sports channels in Brazil.

## `countries` (type: `array`):

Get the top list of each country you pick. Applies to <b>Top list</b>.

## `categories` (type: `array`):

Only channels in these categories. Leave empty for all of them. Applies to <b>Search terms</b> and <b>Top list</b>.

## `maxChannels` (type: `integer`):

How many channels you want from each search term and each top list. A top list holds up to 500 channels.

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

Only channels with at least this many followers. You pay only for the channels that match.

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

Only channels with WhatsApp's green verified badge.

## Actor input object example

```json
{
  "searchQueries": [
    "football"
  ],
  "topList": "none",
  "countries": [
    "US"
  ],
  "maxChannels": 100,
  "verifiedOnly": false
}
```

# Actor output Schema

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

No description

# 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": [
        "football"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("vero-api/whatsapp-channel-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": ["football"] }

# Run the Actor and wait for it to finish
run = client.actor("vero-api/whatsapp-channel-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": [
    "football"
  ]
}' |
apify call vero-api/whatsapp-channel-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,vero-api/whatsapp-channel-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/7PnpM7zMlMNCD1an3/builds/71wCQiGZkCpfFBcxc/openapi.json
