# Wechat Phone Number Scraper (`scraperoka/wechat-phone-number-scraper`) Actor

📱 Wechat Phone Number Scraper extracts verified WeChat phone numbers for targeted outreach. ✅ Fast, accurate, and ideal for B2B lead generation, sales, and market research. 🚀 Improve campaigns with cleaner, actionable contact data.

- **URL**: https://apify.com/scraperoka/wechat-phone-number-scraper.md
- **Developed by:** [Scraperoka](https://apify.com/scraperoka) (community)
- **Categories:** Lead generation, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

### Wechat Phone Number Scraper ⚡

Manually visiting hundreds of Wechat profiles to collect phone numbers wastes hours you don’t have. **Wechat Phone Number Scraper** automates bulk extraction of phone numbers from public Wechat profiles using your keywords and country targeting. This Wechat phone number scraper is ideal for marketers, recruiters, and growth teams that need a Wechat leads scraper to produce usable lists in a single run. In practice, you can generate thousands of leads worth of structured results faster than manual research.

***

### What You Get: Sample Output

Here's a sample record from a single run:

```json
{
  "platform": "Wechat",
  "keyword": "marketing",
  "title": "Marketing Services & Founder Info",
  "description": "No data",
  "url": "https://example.com/profile/marketing-founder",
  "phone_number": "+447700900123",
  "country": "United Kingdom",
  "dial_code": "+44"
}
```

| Field | Type | What It Tells You |
|---|---|---|
| `platform` | string | The source platform for the contact (set to `Wechat`) |
| `keyword` | string | The keyword that triggered this match in your Wechat phone number finder run |
| `title` | string | The page title text linked to the contact match (useful for context) |
| `description` | string | The extracted text block around the match (helps validate relevance) |
| `url` | string | The reference URL where the phone number was detected |
| `phone_number` | string | The unique phone number in E.164 format (deduplicated across the run) |
| `country` | string | The country name you targeted for phone number extraction |
| `dial_code` | string | The dial code associated with your selected country |

Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard.

***

### Why Wechat Phone Number Scraper?

There are a lot of ways to pull data from Wechat — here’s what sets **Wechat Phone Number Scraper** (wechat phone number scraper, wechat contact scraper) apart.

#### Targeted by keywords and country calling codes

You supply `keywords` and choose a `country`, so the scraper focuses on phone numbers associated with your dialing region. This helps reduce irrelevant results when you’re scrape wechat phone numbers at scale for a specific market.

#### Clean, structured output for lead workflows

Each match is written to the dataset as a consistent record containing `phone_number`, `url`, and context fields like `title` and `description`. That makes it easier to build a wechat phone number database you can actually import into outreach and CRM tools.

#### Deduplicated phone numbers across the run

The actor keeps track of already-seen phone numbers and avoids pushing duplicates. The result is a more reliable wechat phone number collection that won’t waste your time with repeats.

#### Resilient runs with progress saving

For longer runs (or when you stop/restart), it loads and saves progress using a key-value store. That means large scraping tasks can resume work rather than starting from zero, helping keep automated wechat contact scraping on track.

***

### Configuring Your Run

Drop this into your `input.json` to get started:

```json
{
  "keywords": ["marketing", "founder"],
  "location": "London",
  "country": "United Kingdom (+44)",
  "maxPhoneNumbers": 50
}
```

| Parameter | Required | What It Does |
|---|---|---|
| `keywords` | ✅ | A list of keywords to guide what the actor looks for when extracting wechat user phone number contacts |
| `location` | ⬜ | Optional location filter text (for example, “London”); leave empty for global search |
| `country` | ✅ | The country to target for phone numbers (selected dialing region) |
| `maxPhoneNumbers` | ⬜ | Stops scraping after this many phone numbers are found (higher values can increase run duration) |

***

### Core Capabilities

#### Keyword-led Wechat phone number extraction

Use your `keywords` to drive what the Wechat Phone Number Scraper tries to match in public web data. This makes it a practical wechat phone number mining tool for lead research and outreach list building.

#### Location filtering (when you need it)

Add a `location` string to narrow results to a specific city/region. It’s a simple way to improve targeting when you’re extracting wechat contact info for a defined geography.

#### Country-specific phone formatting

By choosing `country`, the actor applies the corresponding dialing and region mapping while extracting and formatting phone numbers. The output `phone_number` is pushed in a consistent E.164 format for downstream processing.

#### Stops at your limit to control run scope

Set `maxPhoneNumbers` to cap the number of results per run. This is especially helpful for testing your keyword strategy before you scale up to larger wechat leads scraper workflows.

#### Real-time dataset writing

As the actor finds matches, it pushes records to the default Apify dataset view incrementally. You can monitor progress and begin using the data as soon as it appears.

***

### Who Gets the Most Out of This

Here's how different teams put Wechat Phone Number Scraper to work:

**Growth and lead generation teams** — Use it to scrape wechat phone numbers tied to specific marketing or founder-related keywords, then build a targeted outreach list for a chosen country. The concrete outcome is a structured contact dataset with `phone_number`, `url`, and context fields.

**Sales development representatives** — Feed in `keywords` for your ICP and set the `country` to match your target market. You get a ready-to-import wechat contact list scraper output without manual profile browsing.

**Recruiters and sourcing specialists** — Run targeted searches to collect contact numbers relevant to hiring campaigns in a chosen region. Your outcome is a faster candidate sourcing pipeline based on publicly available profile content.

**Freelance researchers and analysts** — Use the consistent dataset schema to compare phone availability across keyword sets and locations. The outcome is a reproducible wechat phone number database you can analyze in spreadsheets or BI tools.

**Automation engineers and data engineers** — Trigger the Wechat Phone Number Scraper and push results into internal pipelines for enrichment and routing. The concrete outcome is automation-ready data produced in a single, structured dataset.

***

### Step-by-Step: How to Use It

No coding needed. Here's how to run Wechat Phone Number Scraper from start to finish:

1. **Open the actor on Apify** — go to [console.apify.com](https://console.apify.com) and find Wechat Phone Number Scraper.
2. **Enter your inputs** — set `keywords` and choose a `country` (optionally add `location` and `maxPhoneNumbers`).
3. **Configure proxy settings** — use Apify’s built-in proxy support for reliable scraping, especially for larger jobs.
4. **Hit Run and watch the live log** — monitor progress as results are pushed into the dataset incrementally.
5. **View results in the dataset tab** — check records with `phone_number`, `url`, and supporting context fields.
6. **Export as JSON, CSV, or Excel** — download your dataset from the Apify dashboard when the run completes.

The whole process takes under 5 minutes to set up.

***

### Integrations & Export Options

Once your data is collected, Wechat Phone Number Scraper plugs directly into your existing workflow.

Export formats are available directly from the Apify dataset tab as JSON, CSV, or Excel—so you can standardize results for analysis or outreach. If you’re using tools like Google Sheets, Airtable, or CRMs, you can typically import these files immediately.

You can also access results programmatically via the Apify API (see [apify.com/docs/api](https://apify.com/docs/api)) and trigger downstream actions using Apify-native automation features such as webhooks. No-code automation via Zapier or Make can push your dataset records to other systems, and you can schedule runs for recurring lead collection.

***

### Pricing & Free Trial

Wechat Phone Number Scraper runs on the Apify platform, which offers a **free tier** — no credit card required to get started. Free credits on sign-up are typically enough for several test runs so you can validate your `keywords` and `country` strategy.

For larger scraping tasks, Apify uses pay-as-you-go billing based on actor compute units (CU) through the Apify platform. Subscription plans may be a better fit for heavy or enterprise users, depending on your volume.

Start for free at [apify.com](https://apify.com) and scale when you're ready.

***

### Reliability & Performance

| What We Handle | How |
|---|---|
| Result control | Uses your `maxPhoneNumbers` cap to stop after enough phone numbers are collected |
| Deduplication | Avoids pushing already-seen phone numbers across the run |
| Long-task resilience | Saves and resumes progress using Apify key-value storage |
| Data freshness | Outputs records as they are found so you can use partial results immediately |
| Error handling | Includes safeguards to continue processing when individual requests or parsing steps fail |
| Scalability | Supports multiple keywords and large scraping jobs (within platform/runtime constraints) |

**Limitations:** This actor works only with publicly available data and targets phone numbers associated with your selected `country`. If phone numbers are not present in the publicly visible profile content for your chosen keywords, results may be limited.

For enterprise-scale runs, contact us to discuss custom configurations.

***

### Frequently Asked Questions

#### Is there a free plan or trial?

Yes. Apify offers a free tier that you can use for testing before scaling up to paid usage, and the actor is designed to work within those limits.

#### Do I need to log in to Wechat to use this?

No. The actor is intended to work with publicly available sources and does not require Wechat login credentials.

#### How accurate is the data?

Accuracy depends on what the public content actually contains. The actor extracts and validates phone numbers and outputs them as `phone_number` in E.164 format along with the related `url` and context fields.

#### How many results can I get per run?

You control the run scope using `maxPhoneNumbers`. If you don’t set it, the actor will run without your custom cap, subject to free-tier limitations when applicable.

#### How often is the data updated / how fresh is it?

Results reflect what is publicly available at runtime. If you run the actor again later with updated keywords or countries, you’ll get a fresh snapshot based on the current publicly available content.

#### Is this legal? Does it comply with GDPR / CCPA?

It accesses **publicly available data** and does not use login-gated content. Compliance with GDPR, CCPA, platform ToS, and any local regulations when collecting and using contact data is your responsibility.

#### Can I export results to Google Sheets or Excel?

Yes. You can export your dataset from the Apify dashboard as JSON, CSV, or Excel, and then import it into Google Sheets or your CRM/BI tool of choice.

#### Can I run this on a schedule automatically?

Yes. You can schedule Apify actors using Apify platform features, so recurring Wechat contact list scraping can run automatically.

#### Can I access this via API?

Yes. You can retrieve results programmatically using the Apify API (see [apify.com/docs/api](https://apify.com/docs/api)).

#### What happens if the actor hits an error?

The actor is built with resilience: it saves progress and continues pushing what it successfully finds. If individual parsing or extraction steps fail, it doesn’t prevent processing other results, and your dataset will reflect what was captured successfully.

***

### Need Help or Have a Request?

Got a question about Wechat Phone Number Scraper or want a new feature added? Reach out at <dataforleads@gmail.com>. We welcome requests and help with setups, tuning, and troubleshooting. We’re also actively maintaining this actor based on user feedback—ideas like batch CSV upload or webhook notifications on completion are great candidates.

***

### Disclaimer & Responsible Use

*Wechat Phone Number Scraper is the fastest, most reliable way to collect targeted wechat contact leads — start your free run today.*

The actor collects **publicly available data** only. It does not access private profiles, login-gated content, or password-protected pages. You are responsible for GDPR, CCPA, spam regulations, and platform ToS compliance when collecting and using any contact data. For data removal requests, contact <dataforleads@gmail.com>. Use responsibly, ethically, and only for lawful purposes.

# Actor input Schema

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

Enter keywords to search for (e.g., 'Target Keyword').

## `location` (type: `string`):

Filter by location (e.g., 'London', 'California'). Leave empty for global search.

## `country` (type: `string`):

Select the country to target for phone numbers.

## `maxPhoneNumbers` (type: `integer`):

Stop scraping after this many phone numbers are found. Setting a higher limit extends the scraping duration.

## Actor input object example

```json
{
  "keywords": [
    "marketing",
    "founder"
  ],
  "country": "United Kingdom (+44)",
  "maxPhoneNumbers": 20
}
```

# 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 = {
    "keywords": [
        "marketing",
        "founder"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraperoka/wechat-phone-number-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 = { "keywords": [
        "marketing",
        "founder",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("scraperoka/wechat-phone-number-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 '{
  "keywords": [
    "marketing",
    "founder"
  ]
}' |
apify call scraperoka/wechat-phone-number-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scraperoka/wechat-phone-number-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/BdUcjjKQHbpkQwLmu/builds/PSsBFyaD9p30Dgp3f/openapi.json