# Aliexpress Phone Number Scraper (`solid-scraper/aliexpress-phone-number-scraper`) Actor

📲 Aliexpress Phone Number Scraper extracts verified mobile numbers from targeted listings fast. Ideal for lead gen, outreach, and market research—save time and boost campaigns with accurate data. ✅ Export easily & scale smarter. 🚀

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

## Pricing

from $2.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

### AliExpress Phone Number Scraper 🔍

**AliExpress Phone Number Scraper** is an automated actor that scrapes AliExpress for phone numbers related to your target keywords. If you’re doing AliExpress contact scraper work for outreach, lead qualification, or research, this tool helps you quickly surface the phone numbers you need—especially when you want to scrape AliExpress phone numbers at scale instead of manually browsing.

Whether you’re a marketer, sales ops specialist, data analyst, or researcher, this **AliExpress phone number extractor** streamlines the process of finding business contact details from publicly available web data—saving you hours of manual work.

***

### Why choose AliExpress Phone Number Scraper?

| Feature | Benefit |
|---|---|
| ✅ **Keyword-driven extraction** | Finds relevant AliExpress seller contact details using the keywords you provide |
| ✅ **Country dial-code filtering** | Focuses results using the selected country dial code for more relevant phone numbers |
| ✅ **Built-in proxy support for reliable scraping** | Improves consistency when scraping across different network conditions |
| ✅ **Fallback logic for empty results** | Automatically attempts an alternative run when no phone numbers are found |
| ✅ **Structured JSON output** | Returns a consistent dataset with `keyword`, `title`, `url`, `description`, and `phone_number` fields |
| ✅ **Ready for automation** | Easily export and feed results into your CRM lead scraping or data workflows |

***

### Key features

- 🔎 **AliExpress phone number extraction:** Extracts phone numbers from publicly available sources associated with your keywords
- 🧩 **Keyword list support:** Run with multiple keywords in a single run to build a broader AliExpress business contact scraper output
- 🌍 **Country dial-code targeting:** Uses your selected country to format and validate phone numbers consistently
- 🛡️ **Proxy configuration support:** Lets you configure proxies for this actor to keep scraping stable at scale
- 🔄 **Resilient fallback behavior:** If a run yields no numbers, it can switch to an alternative approach and try again
- 📊 **Deduplicated phone numbers:** Ensures each unique `phone_number` is captured once per dataset build
- 💾 **Structured dataset output:** Pushes results as JSON records you can export and analyze right away
- 🔁 **Enriched context per lead:** Each record includes the source `title`, `url`, and extracted `description` alongside the phone number

***

### Input

Provide input via an `input.json` file. Example structure:

```json
{
  "keywords": ["John", "Air Fryer"],
  "location": "",
  "platform": "AliExpress",
  "country": "United Kingdom (+44)",
  "proxyConfiguration": {}
}
```

#### Input Fields

| Field | Required | Description |
|---|---:|---|
| `keywords` | ✅ | A list of keywords to search for. Use this to target the AliExpress contact leads you care about (e.g., “John”, “Air Fryer”). |
| `location` | ❌ | Optional location text to narrow down results. Leave it empty (`""`) if you don’t need location filtering. |
| `platform` | ❌ | Select platform. The actor expects `AliExpress` and will use `AliExpress` even if you pass a different value. |
| `country` | ✅ | Select a country to scrape related phone numbers. This drives the dial code used to validate and format extracted numbers. |
| `proxyConfiguration` | ❌ | Configure proxies for this actor. Use the Apify proxy configuration UI/object to manage proxy behavior. |

***

### Output

The actor saves the extracted results into a dataset as JSON records.

Example output:

```json
[
  {
    "keyword": "John",
    "title": "Example title",
    "url": "http://example.com",
    "description": "Example extracted description text",
    "phone_number": "+447700900123"
  }
]
```

#### Output Fields

| Field | Type | Description |
|---|---|---|
| `keyword` | string | The keyword that was used for the scrape that produced this record |
| `title` | string | The title text associated with the found result item |
| `url` | string | The source URL associated with the found result item |
| `description` | string | The extracted description text used for phone number matching |
| `phone_number` | string | The extracted, formatted phone number (deduplicated across the run) |

The actor also logs the total number of unique phone numbers extracted at the end of the run.

***

### How to use AliExpress Phone Number Scraper (via Apify Console)

1. **Open Apify Console**\
   Log in at [console.apify.com](https://console.apify.com) and go to the **Actors** tab.

2. **Find and open the actor**\
   Search for **AliExpress Phone Number Scraper** and open its actor page.

3. **Enter your INPUT**\
   In the **INPUT** section, set:
   `keywords` (required) and `country` (required).\
   Optionally add `location` to narrow results and keep `platform` as `AliExpress`.

4. **Configure proxies (optional but recommended for scale)**\
   In **Proxy Configuration**, use the built-in proxy settings to help scraping run reliably.

5. **Run the actor**\
   Click **Run**. During execution, you’ll see logs for input values, extraction events, and any fallback behavior if no results are found for a keyword.

6. **Review results in the OUTPUT tab**\
   After the run finishes, open the dataset from the **OUTPUT** tab.

7. **Export to JSON/CSV**\
   Export the dataset and use it in your workflow (for example, importing into a CRM for AliExpress CRM lead scraping).

No coding required—get accurate phone number leads in minutes with **AliExpress Phone Number Scraper**. ✅

***

### Advanced features & SEO optimization

- 🧠 **Engineered for “AliExpress phone number extractor” workflows:** Built specifically to help you scrape AliExpress phone numbers using your `keywords` list and country dial-code validation
- 🌍 **Location-aware lead discovery:** Add `location` when you want an AliExpress store contact scraper output that’s more geographically targeted
- 🧷 **Phone-number deduplication:** Keeps results cleaner by ensuring each unique `phone_number` appears only once in the output
- 🛡️ **Reliability through proxy configuration and fallback:** Includes resilience so you’re not blocked when one attempt yields no matches
- 📊 **Structured dataset for downstream use:** Output records are ready for analysis, enrichment, and outreach planning as an AliExpress email and phone scraper style dataset (phone\_number plus context)

***

### Best use cases

- 📈 **Sales teams building outreach lists:** Generate a targeted AliExpress supplier phone number scraper dataset to speed up prospecting
- 🎯 **Marketing ops for campaign targeting:** Use keyword + country filtering to build segmented buyer contact data for faster campaign setup
- 🧾 **Data analysts enriching lead databases:** Combine `keyword`, `url`, and `description` context with `phone_number` for analysis and deduping
- 🏪 **Ecommerce research & competitive intelligence:** Extract AliExpress product contact details scraper phone numbers to benchmark suppliers
- 🤝 **CRM teams running enrichment pipelines:** Feed results into your CRM as part of an AliExpress CRM lead scraping workflow
- 🧑‍💼 **Lead qualification for B2B development:** Use country-specific formatting to keep contacts consistent and outreach-ready
- 📱 **WhatsApp outreach preparation:** Extract phone numbers that are discoverable in the targeted sources for AliExpress WhatsApp phone number scraper use cases

***

### Technical specifications

- **Supported Input Formats**
  - ✅ `keywords` (array of strings)
  - ✅ `location` (string, optional)
  - ✅ `platform` (string; actor uses `AliExpress`)
  - ✅ `country` (string selection like `United Kingdom (+44)`)
  - ✅ `proxyConfiguration` (Apify proxy configuration object)

- **Proxy Support**
  - ✅ Configurable proxies via `proxyConfiguration`
  - ✅ Includes fallback behavior when no numbers are found for a keyword

- **Retry Mechanism**
  - ✅ Includes resilience logic through fallback behavior (no manual retry required)

- **Dataset Structure**
  - ✅ JSON dataset containing records with `keyword`, `title`, `url`, `description`, `phone_number`

- **Rate Limits & Performance**
  - ✅ Designed for batch-style runs driven by your `keywords` list (performance depends on environment and network conditions)

- **Limitations**
  - ❌ Only phone numbers available in the matched public source content are returned
  - ❌ Results depend on what phone numbers appear in publicly available data for the given inputs

***

### FAQ

#### Is this tool only for AliExpress?

✅ Yes. The actor is set up to scrape AliExpress, and if `platform` is provided as anything other than `AliExpress`, the actor will still use `AliExpress`.

#### What do I need to provide to get results?

You must provide `keywords` and `country`. `location` and `proxyConfiguration` are optional, but they can improve relevance and reliability.

#### What phone number format do I receive?

The output `phone_number` is formatted in E.164 format (example: `+447700900123`) and is deduplicated across the run.

#### Does it return phone numbers only, or extra context too?

It returns phone numbers along with additional context fields: `keyword`, `title`, `url`, and `description`, so you can quickly verify and use the leads.

#### Can I scrape multiple keywords in one run?

✅ Yes. Provide multiple values in the `keywords` array to produce a combined dataset across keywords.

#### How does the actor handle reliability if a keyword returns no results?

If no phone numbers are found for a keyword, the actor can perform a fallback attempt using an alternative scraping path and then continue processing.

#### Can I use these results for outreach?

You can use the dataset for legitimate outreach and enrichment purposes, but you should ensure compliance with applicable laws and platform rules. The output is based only on publicly accessible data.

#### Do you support exporting to CSV?

The actor outputs a JSON dataset. In Apify Console, you can typically export datasets (for example, to CSV) from the dataset viewer.

***

### Support & feature requests

Want to improve **AliExpress Phone Number Scraper** or suggest a better workflow for scraping AliExpress contact data? 💡 Tell us what would make the next version more useful.

- 💡 **Feature Requests:** Examples include CSV export customization, additional output fields, or more filters for AliExpress buyer contact info scraper use cases.
- 📧 **Contact:** Reach us at <dataforleads@gmail.com>.

Your feedback directly shapes the roadmap for this AliExpress phone number scraping tool. ✅

***

*If you’re looking for the most practical and SEO-optimized way to scrape AliExpress phone numbers, **AliExpress Phone Number Scraper** is built to help you move from research to results fast—at scale.*

***

### Disclaimer

**This tool accesses publicly accessible sources only.** It does not access private profiles, authenticated data, or password-protected content.

You are responsible for compliance with applicable laws (including GDPR and CCPA where relevant), spam regulations, and platform terms of service. Use this actor responsibly, ethically, and for legitimate purposes.

For data-removal requests, contact <dataforleads@gmail.com>.

# Actor input Schema

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

A list of keywords to search for. (Example: John, Air Fryer, etc.)

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

Optional location to narrow down search results.

## `platform` (type: `string`):

Select platform.

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

Select a country to scrape related phone numbers.

## `proxyConfiguration` (type: `object`):

Configure proxies for this Actor.

## Actor input object example

```json
{
  "keywords": [
    "John",
    "Air Fryer"
  ],
  "location": "",
  "platform": "AliExpress",
  "country": "United Kingdom (+44)"
}
```

# 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": [
        "John",
        "Air Fryer"
    ],
    "location": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("solid-scraper/aliexpress-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": [
        "John",
        "Air Fryer",
    ],
    "location": "",
}

# Run the Actor and wait for it to finish
run = client.actor("solid-scraper/aliexpress-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": [
    "John",
    "Air Fryer"
  ],
  "location": ""
}' |
apify call solid-scraper/aliexpress-phone-number-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/aNACtOlhwu2yA5QAb/builds/rQ4HLcpbE0E6H5pxv/openapi.json