# 📞 Shopee Phone Number Scraper (`scrapelabsapi/shopee-phone-number-scraper`) Actor

- **URL**: https://apify.com/scrapelabsapi/shopee-phone-number-scraper.md
- **Developed by:** [ScrapeLabs](https://apify.com/scrapelabsapi) (community)
- **Categories:** Automation, Lead generation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

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

### **Shopee** Phone Number Scraper 📱

**Shopee** Phone Number Scraper allows users to **extract** valuable **contact** information from **Shopee** profiles and listings. This tool is designed to gather **phone numbers** and other essential details to support marketing, research, and customer outreach efforts.

By using the **Shopee** Phone Number Scraper, you can automate the process of collecting **phone numbers** from **Shopee** profiles. This **Shopee** customer phone **extract**or ensures accurate and reliable **data** **extract**ion for all your business needs.

Whether you are exploring how to scrape **Shopee** **phone numbers** or require a **Shopee** phone number **extract**ion tool for large-scale tasks, this scraper is the perfect solution. It is optimized to handle **Shopee**'s platform structure, ensuring seamless **data** scraping without interruptions or errors.

Shopee Phone Number Scraper is a powerful tool designed to help users efficiently extract contact details from Shopee. It simplifies the process of gathering phone numbers from Shopee profiles and listings.

With the Shopee Phone Number Scraper, you can save time and effort by automating the data collection process. This Shopee contact scraper tool is ideal for businesses and researchers looking to extract phone numbers from Shopee quickly and accurately.

Shopee Phone Number Scraper is built using advanced Shopee data scraping software to ensure precise and reliable results. It is designed to handle large-scale scraping tasks while maintaining data accuracy.

### Support and feedback

- **Bug reports**: Open a ticket in the repository Issues section
- **Custom features**: Contact our enterprise support team
  *Email: dev.scraperengine@gmail.com*
### Extractable Data Table 📊
| Data Type | Description |
| --- | --- |
| Phone Numbers | Extract phone numbers from Shopee profiles and listings with high accuracy using the best Shopee scraper for contacts. |
| Seller Names | Retrieve seller names from Shopee user data scraping for better customer identification and outreach. |
| Shop Names | Collect shop names to associate contact numbers with specific Shopee stores for targeted marketing. |
| Product Details | Scrape product details along with contact information for comprehensive Shopee user data scraping. |
| Email Addresses | Capture email addresses alongside phone numbers to enhance your customer contact database. |
| Ratings and Reviews | Extract ratings and reviews to analyze customer feedback while performing Shopee scraping automation. |
| Location Data | Retrieve location data from Shopee profiles to segment your audience based on geographic regions. |
| Profile Links | Gather profile links to maintain direct access to Shopee user profiles for future reference. |

### Key Features of **Shopee** Phone Number Scraper

Here are the **standout features** that make the **Shopee** Phone Number Scraper a **top-tier tool** for **marketers**, **agencies**, and **researchers**:

- ⭐ **Automated** scraping ensures fast and efficient data collection with the **Shopee** Phone Number Scraper
- ⭐ **Customizable** filters allow you to target specific **Shopee** profiles for precise data extraction
- ⭐ User-friendly interface makes it easy to operate the **Shopee** phone number finder without technical expertise
- ⭐ **High** accuracy ensures reliable results when extracting phone numbers and other data from **Shopee**
- ⭐ Supports large-scale **Shopee** scraping automation for businesses handling extensive data requirements
- ⭐ Real-time scraping keeps your data up-to-date with the latest **Shopee** profile information
- ⭐ **Secure** scraping methods protect your activities while using the **Shopee** Phone Number Scraper
- ⭐ **Advanced** algorithms optimize the extraction process for maximum efficiency and speed
- ⭐ Seamless integration with other tools enhances the usability of the **Shopee** phone number extraction tool
- ⭐ Detailed logs provide transparency and tracking for all **Shopee** user data scraping activities
- ⭐ Cloud-based functionality ensures accessibility from any device for remote **Shopee** scraping tasks
- ⭐ **Regular** updates keep the scraper compatible with **Shopee**s platform changes for uninterrupted performance

### How to use **Shopee** Phone Number Scraper 🚀

Follow this **simple, step-by-step guide** to start extracting **Shopee** phone numbers today:

1. ✅ Download and install the **Shopee** Phone Number Scraper on your device
2. ✅ Log in to your **Shopee** account to access the platform for scraping
3. ✅ Set your scraping preferences using the **Shopee** contact scraper tool interface
4. ✅ Enter the target URLs or keywords to extract phone numbers from **Shopee** profiles
5. ✅ **Start** the scraping process and let the tool gather data automatically
6. ✅ **Review** the extracted data in the **Shopee** Phone Number Scraper dashboard
7. ✅ **Export** the data in your preferred format for further analysis or use
8. ✅ Regularly update the tool to ensure compatibility with **Shopee**s platform changes

### Use Cases 🎯

Business Outreach
🎯 Gather phone numbers for direct marketing campaigns using the **Shopee** Phone Number Scraper
🎯 **Identify** potential leads by extracting contact information from **Shopee** profiles

Market Research
🎯 **Analyze** customer demographics by performing **Shopee** data scraping software tasks
🎯 **Collect** contact details to survey **Shopee** users and understand market trends

E-commerce Growth
🎯 Expand your online store by connecting with **Shopee** sellers using the **Shopee** customer phone extractor
🎯 Extract phone numbers to collaborate with **Shopee** shop owners for mutual growth

Agency Use
🎯 Provide data scraping services to clients using the **Shopee** phone number extraction tool
🎯 **Automate** data collection for agencies managing large-scale **Shopee** scraping automation projects

### Why choose us? 💎

**Shopee** Phone Number Scraper is the ultimate solution for extracting contact details from **Shopee** profiles. It is designed to deliver fast, accurate, and **reliable** results for businesses and individuals.

This **Shopee** phone number extraction tool is built with **advanced** features to simplify the data scraping process. It ensures compliance with **Shopee**'s platform guidelines while maintaining high efficiency.

As the **best** **Shopee** scraper for contacts, it offers seamless integration with other tools for enhanced usability. **Shopee** Phone Number Scraper is optimized for large-scale tasks, making it ideal for businesses with extensive data requirements.

Whether you need **Shopee** user data scraping for research or marketing, this tool guarantees exceptional performance. Choose **Shopee** Phone Number Scraper for its reliability, ease of use, and unparalleled features.

### **Shopee** Phone Number Scraper Scalability 📈

**Shopee** Phone Number Scraper is designed to handle projects of any size with ease. Whether you need to extract a few phone numbers or perform **large-scale** **Shopee** scraping automation, this tool is up to the task.

It supports high-volume data extraction without compromising on accuracy or speed. **Shopee** Phone Number Scraper is optimized to process thousands of **Shopee** profiles **efficient**ly.

Its **advanced** algorithms ensure scalability for businesses with growing data needs. **Shopee** Phone Number Scraper adapts to your requirements, making it the perfect choice for scalable data scraping.

It is built to handle **Shopee** phone number finder tasks for small and large projects alike.

### **Shopee** Phone Number Scraper Legal Guidelines ⚖️

**Yes**—scraping **Shopee** is **legal** as long as you follow **ethical** and **compliant** practices. The **Shopee** Phone Number Scraper extracts only **publicly available** information from **public** **Shopee** profiles, making it **safe** and **compliant** for **research**, **marketing**, and **analysis**.

#### Legal & Ethical Guidelines
⚖️ Always comply with **Shopee**s terms of service when using the **Shopee** Phone Number Scraper
⚖️ **Avoid** scraping data that is not publicly available or requires login credentials
⚖️ **Use** the **Shopee** contact scraper tool for ethical purposes only such as research or marketing
⚖️ **Ensure** that you have permission to extract phone numbers from **Shopee** profiles
⚖️ **Do not** use the **Shopee** Phone Number Scraper for spamming or unsolicited marketing activities
⚖️ Regularly review **Shopee**s policies to stay updated on acceptable scraping practices
⚖️ Protect the privacy of **Shopee** users by securely storing extracted data
⚖️ Respect regional data protection laws when performing **Shopee** scraping automation

### Input Parameters 🧩
📦 Example Input (JSON)
```json
{
  "keywords": ["Shopee Phone Number Scraper"],
  "country": "Global",
  "maxPhoneNumbers": 20,
  "platform": "Shopee",
  "engine": "legacy"
}
````

### Input Table

| Data Type | Description |
| --- | --- |
| keywords | Keywords to find relevant profiles |
| country | Country setting (Global) |
| maxPhoneNumbers | Maximum phone numbers to collect (default 20) |
| platform | Platform to scrape (Shopee) |
| engine | Engine type (legacy) |
| proxyConfiguration | Optional proxy settings |

### Output Format 📤

📝 Example Output (JSON)

```json
[
  {
    "platform": "Shopee",
    "keyword": "Shopee Phone Number Scraper",
    "title": "Example Shopee profile",
    "description": "Example description with phone number",
    "url": "https://www.example.com/example/",
    "phone_number": "+1234567890",
    "country": "Global",
    "dial_code": "Auto-detected"
  }
]
```

### Output Table

| Data Type | Description |
| --- | --- |
| platform | Identifies Shopee as the source |
| keyword | Keyword that triggered the result (Shopee Phone Number Scraper) |
| title | Profile title or username |
| description | Public bio snippet with contact info |
| url | Direct Shopee profile link |
| phone\_number | Extracted phone number with Auto-detected dial code |
| country | Country setting (Global) |
| dial\_code | Dial code (Auto-detected) |

### FAQ ❓

#### What is Shopee **Phone Number Scraper**?

Shopee Phone Number Scraper is a tool designed to extract **phone numbers** and other contact details from Shopee profiles and listings.

#### How does Shopee **Phone Number Scraper** work?

It automates the process of gathering data from Shopee profiles using advanced Shopee data scraping software.

#### Can I **extract** phone numbers from Shopee profiles?

**Yes**, the Shopee Phone Number Scraper allows you to extract **phone numbers** from Shopee profiles with ease.

#### Is Shopee **Phone Number Scraper** easy to use?

**Yes**, it features a **user-friendly** interface that simplifies the process of Shopee user data scraping.

#### What data can I **extract** using this tool?

You can extract **phone numbers**, seller names, shop names, and more using the Shopee customer phone extractor.

#### Is Shopee **Phone Number Scraper** **legal** to use?

**Yes**, as long as you comply with Shopee's terms of service and use the tool ethically.

#### Can I automate data scraping with this tool?

**Yes**, the Shopee Phone Number Scraper supports Shopee scraping automation for large-scale projects.

#### Does this tool support **export**ing data?

**Yes**, you can export extracted data in various formats for further analysis or use.

#### Is the data accurate?

**Yes**, the Shopee Phone Number Scraper ensures high accuracy in all data extraction tasks.

#### Can I use this tool for business purposes?

**Yes**, it is ideal for **businesses** looking to extract **phone numbers** from Shopee for outreach and marketing.

#### Does it work with all Shopee regions?

**Yes**, the tool is designed to work across all Shopee regions and platforms.

#### How often is the tool updated?

The Shopee Phone Number Scraper is regularly updated to ensure compatibility with Shopee's platform changes.

#### Can I scrape multiple profiles at once?

**Yes**, the tool supports batch scraping for efficient data collection.

#### Is my data **secure** while using this tool?

**Yes**, the Shopee Phone Number Scraper uses **secure** methods to protect your data and activities.

#### What makes this the best Shopee scraper for contacts?

Its advanced features, high accuracy, and ease of use make it the best choice for extracting contacts from Shopee.

# Actor input Schema

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

📝 Add search terms (e.g. "marketing", "founder"). The actor finds Shopee links for each keyword and extracts phone numbers from snippets and page content.

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

🌐 Marketplace to target. Currently supports Shopee (searched via Google).

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

📍 Choose the country for phone number filtering. Only numbers with the selected dial code are collected and normalized.

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

📊 Cap how many phone numbers to collect per keyword (1–10000). The run stops for that keyword once the limit is reached.

## `engine` (type: `string`):

🔧 Proxy mode: legacy uses GOOGLE\_SERP for Google search. Required for reliable SERP access.

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

🌐 Apify proxy settings. The actor uses GOOGLE\_SERP for search; configure here if you use custom proxy options.

## Actor input object example

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

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

// Run the Actor and wait for it to finish
const run = await client.actor("scrapelabsapi/shopee-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"] }

# Run the Actor and wait for it to finish
run = client.actor("scrapelabsapi/shopee-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"
  ]
}' |
apify call scrapelabsapi/shopee-phone-number-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "📞 Shopee Phone Number Scraper",
        "version": "0.1",
        "x-build-id": "7xs0MlZg2aQ0EJGTE"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapelabsapi~shopee-phone-number-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapelabsapi-shopee-phone-number-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/scrapelabsapi~shopee-phone-number-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapelabsapi-shopee-phone-number-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/scrapelabsapi~shopee-phone-number-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapelabsapi-shopee-phone-number-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",
                "required": [
                    "keywords",
                    "country"
                ],
                "properties": {
                    "keywords": {
                        "title": "🔑 Keywords",
                        "type": "array",
                        "description": "📝 Add search terms (e.g. \"marketing\", \"founder\"). The actor finds Shopee links for each keyword and extracts phone numbers from snippets and page content.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "platform": {
                        "title": "🛒 Platform",
                        "enum": [
                            "Shopee"
                        ],
                        "type": "string",
                        "description": "🌐 Marketplace to target. Currently supports Shopee (searched via Google).",
                        "default": "Shopee"
                    },
                    "country": {
                        "title": "🌍 Country",
                        "enum": [
                            "Afghanistan (+93)",
                            "Albania (+355)",
                            "Algeria (+213)",
                            "Andorra (+376)",
                            "Angola (+244)",
                            "Antigua And Barbuda (+1-268)",
                            "Argentina (+54)",
                            "Armenia (+374)",
                            "Australia (+61)",
                            "Austria (+43)",
                            "Azerbaijan (+994)",
                            "Bahamas (+1-242)",
                            "Bahrain (+973)",
                            "Bangladesh (+880)",
                            "Barbados (+1-246)",
                            "Belarus (+375)",
                            "Belgium (+32)",
                            "Belize (+501)",
                            "Benin (+229)",
                            "Bhutan (+975)",
                            "Bolivia (+591)",
                            "Bosnia And Herzegovina (+387)",
                            "Botswana (+267)",
                            "Brazil (+55)",
                            "Brunei (+673)",
                            "Bulgaria (+359)",
                            "Burkina Faso (+226)",
                            "Burundi (+257)",
                            "Cambodia (+855)",
                            "Cameroon (+237)",
                            "Canada (+1)",
                            "Cape Verde (+238)",
                            "Central African Republic (+236)",
                            "Chad (+235)",
                            "Chile (+56)",
                            "China (+86)",
                            "Colombia (+57)",
                            "Comoros (+269)",
                            "Congo (Democratic Republic) (+243)",
                            "Congo (Republic) (+242)",
                            "Costa Rica (+506)",
                            "Croatia (+385)",
                            "Cuba (+53)",
                            "Cyprus (+357)",
                            "Czech Republic (+420)",
                            "Denmark (+45)",
                            "Djibouti (+253)",
                            "Dominica (+1-767)",
                            "Dominican Republic (+1-809)",
                            "East Timor (+670)",
                            "Ecuador (+593)",
                            "Egypt (+20)",
                            "El Salvador (+503)",
                            "Equatorial Guinea (+240)",
                            "Eritrea (+291)",
                            "Estonia (+372)",
                            "Eswatini (+268)",
                            "Ethiopia (+251)",
                            "Fiji (+679)",
                            "Finland (+358)",
                            "France (+33)",
                            "Gabon (+241)",
                            "Gambia (+220)",
                            "Georgia (+995)",
                            "Germany (+49)",
                            "Ghana (+233)",
                            "Greece (+30)",
                            "Grenada (+1-473)",
                            "Guatemala (+502)",
                            "Guinea (+224)",
                            "Guinea-Bissau (+245)",
                            "Guyana (+592)",
                            "Haiti (+509)",
                            "Honduras (+504)",
                            "Hungary (+36)",
                            "Iceland (+354)",
                            "India (+91)",
                            "Indonesia (+62)",
                            "Iran (+98)",
                            "Iraq (+964)",
                            "Ireland (+353)",
                            "Israel (+972)",
                            "Italy (+39)",
                            "Jamaica (+1-876)",
                            "Japan (+81)",
                            "Jordan (+962)",
                            "Kazakhstan (+7)",
                            "Kenya (+254)",
                            "Kiribati (+686)",
                            "Korea, North (+850)",
                            "Korea, South (+82)",
                            "Kuwait (+965)",
                            "Kyrgyzstan (+996)",
                            "Laos (+856)",
                            "Latvia (+371)",
                            "Lebanon (+961)",
                            "Lesotho (+266)",
                            "Liberia (+231)",
                            "Libya (+218)",
                            "Liechtenstein (+423)",
                            "Lithuania (+370)",
                            "Luxembourg (+352)",
                            "Madagascar (+261)",
                            "Malawi (+265)",
                            "Malaysia (+60)",
                            "Maldives (+960)",
                            "Mali (+223)",
                            "Malta (+356)",
                            "Marshall Islands (+692)",
                            "Mauritania (+222)",
                            "Mauritius (+230)",
                            "Mexico (+52)",
                            "Micronesia (+691)",
                            "Moldova (+373)",
                            "Monaco (+377)",
                            "Mongolia (+976)",
                            "Montenegro (+382)",
                            "Morocco (+212)",
                            "Mozambique (+258)",
                            "Myanmar (+95)",
                            "Namibia (+264)",
                            "Nauru (+674)",
                            "Nepal (+977)",
                            "Netherlands (+31)",
                            "New Zealand (+64)",
                            "Nicaragua (+505)",
                            "Niger (+227)",
                            "Nigeria (+234)",
                            "North Macedonia (+389)",
                            "Norway (+47)",
                            "Oman (+968)",
                            "Pakistan (+92)",
                            "Palau (+680)",
                            "Panama (+507)",
                            "Papua New Guinea (+675)",
                            "Paraguay (+595)",
                            "Peru (+51)",
                            "Philippines (+63)",
                            "Poland (+48)",
                            "Portugal (+351)",
                            "Qatar (+974)",
                            "Romania (+40)",
                            "Russia (+7)",
                            "Rwanda (+250)",
                            "Saint Kitts And Nevis (+1-869)",
                            "Saint Lucia (+1-758)",
                            "Saint Vincent And The Grenadines (+1-784)",
                            "Samoa (+685)",
                            "San Marino (+378)",
                            "Sao Tome And Principe (+239)",
                            "Saudi Arabia (+966)",
                            "Senegal (+221)",
                            "Serbia (+381)",
                            "Seychelles (+248)",
                            "Sierra Leone (+232)",
                            "Singapore (+65)",
                            "Slovakia (+421)",
                            "Slovenia (+386)",
                            "Solomon Islands (+677)",
                            "Somalia (+252)",
                            "South Africa (+27)",
                            "South Sudan (+211)",
                            "Spain (+34)",
                            "Sri Lanka (+94)",
                            "Sudan (+249)",
                            "Suriname (+597)",
                            "Sweden (+46)",
                            "Switzerland (+41)",
                            "Syria (+963)",
                            "Taiwan (+886)",
                            "Tajikistan (+992)",
                            "Tanzania (+255)",
                            "Thailand (+66)",
                            "Togo (+228)",
                            "Tonga (+676)",
                            "Trinidad And Tobago (+1-868)",
                            "Tunisia (+216)",
                            "Turkey (+90)",
                            "Turkmenistan (+993)",
                            "Tuvalu (+688)",
                            "Uganda (+256)",
                            "Ukraine (+380)",
                            "United Arab Emirates (+971)",
                            "United Kingdom (+44)",
                            "United States (+1)",
                            "Uruguay (+598)",
                            "Uzbekistan (+998)",
                            "Vanuatu (+678)",
                            "Vatican City (+39-06)",
                            "Venezuela (+58)",
                            "Vietnam (+84)",
                            "Yemen (+967)",
                            "Zambia (+260)",
                            "Zimbabwe (+263)"
                        ],
                        "type": "string",
                        "description": "📍 Choose the country for phone number filtering. Only numbers with the selected dial code are collected and normalized.",
                        "default": "United Kingdom (+44)"
                    },
                    "maxPhoneNumbers": {
                        "title": "🎯 Max phone numbers per keyword",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "📊 Cap how many phone numbers to collect per keyword (1–10000). The run stops for that keyword once the limit is reached.",
                        "default": 20
                    },
                    "engine": {
                        "title": "⚙️ Engine",
                        "enum": [
                            "legacy"
                        ],
                        "type": "string",
                        "description": "🔧 Proxy mode: legacy uses GOOGLE_SERP for Google search. Required for reliable SERP access.",
                        "default": "legacy"
                    },
                    "proxyConfiguration": {
                        "title": "🔒 Proxy",
                        "type": "object",
                        "description": "🌐 Apify proxy settings. The actor uses GOOGLE_SERP for search; configure here if you use custom proxy options."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
