# Telegram Phone Number Scraper (`scrapers-hub/telegram-phone-number-scraper`) Actor

📞 Telegram Phone Number Scraper extracts phone numbers from Telegram profiles with speed and precision. 🚀 Perfect for lead generation, sales outreach & market research. 🔍 Save time, target better, grow smarter.

- **URL**: https://apify.com/scrapers-hub/telegram-phone-number-scraper.md
- **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community)
- **Categories:** Lead generation, Social media, Automation
- **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 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/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

### Telegram Phone Number Scraper 🔍

**Telegram Phone Number Scraper** automatically extracts phone numbers from publicly available Telegram profiles, bios, and post content using your provided keywords and a country targeting filter. Whether you’re using a **telegram phone number scraper** for lead generation, a **telegram contacts scraper** for audience research, or a **telegram user phone number extractor** for data enrichment, this actor helps you collect usable contact data at scale—saving you hours of manual searching.

---

### 🚀 Why choose Telegram Phone Number Scraper?

| Feature | Benefit |
| --- | --- |
| ✅ **Keyword-driven extraction** | Finds relevant Telegram profiles using your keywords and country targeting |
| ✅ **Country code filtering** | Focuses extraction on the phone numbers matching your selected country |
| ✅ **Bulk extraction controls** | Stops after `maxPhoneNumbers` are found so you can plan runs |
| ✅ **Resilient scraping behavior** | Includes retries and fallbacks for resilience when results are limited |
| ✅ **Structured dataset output** | Saves results with consistent fields for easy export and analysis |
| ✅ **Incremental saving** | Pushes each found record to the dataset as it’s discovered |

---

### 🔑 Key features

- 🔎 **Telegram phone number harvesting**: Extracts phone numbers from Telegram profiles, bios, and post content using your keywords.
- 🎯 **Country-targeted results**: Uses your selected country to improve the relevance of extracted numbers.
- 🧠 **Smart result limits**: Lets you cap the run with `maxPhoneNumbers` (e.g., for test runs or controlled batches).
- 🛡️ **Reliability-focused runs**: Built-in resilience (including retries and fallbacks) to keep long jobs moving.
- 💾 **Dataset-friendly output**: Each match is stored with fields like `keyword`, `title`, `url`, and `phone_number`.
- 🔄 **Resumable progress**: Uses a stored progress key so long runs can continue where they left off.

---

### 📝 Input

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

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

#### Input Fields

| Field | Required | Description |
| --- | --- | --- |
| `keywords` | Yes | List of keywords used to find relevant Telegram profiles and content for phone number extraction. |
| `location` | No | Optional location filter (for example, `London` or `California`). Leave empty for a global search. |
| `country` | Yes | Target country for phone numbers. The actor uses this to focus extraction on that country’s dialing format. |
| `maxPhoneNumbers` | No | Maximum number of phone numbers to find before stopping. Higher values can extend runtime (default is 20, max is 10000). |

***

### 📦 Output

The actor saves each scraped result into the dataset as JSON objects pushed to the default dataset view **“Scraped Phone Numbers”** (table view).

Example output record:

```json
[
  {
    "platform": "Telegram",
    "keyword": "marketing",
    "title": "Some Telegram result title",
    "description": "Some extracted text that may contain a phone number",
    "url": "https://example.com/some-profile",
    "phone_number": "+447700900123",
    "country": "United Kingdom",
    "dial_code": "+44"
  }
]
```

#### Output Fields

| Field | Type | Description |
| --- | --- | --- |
| `platform` | string | Always set to `Telegram` for this actor’s results. |
| `keyword` | string | The keyword used for the extraction run that produced this result. |
| `title` | string | The title associated with the extracted result. |
| `description` | string | Text extracted from the source content where the phone number was found. |
| `url` | string | The URL pointing to the Telegram-related source for this record. |
| `phone_number` | string | Extracted phone number in E.164 format (e.g., `+4477...`). |
| `country` | string | Country name derived from your selected country option. |
| `dial_code` | string | Dial code derived from your selected country option. |

After exporting, you can use the data as input for pipelines that support **telegram phone numbers for marketing**, **telegram lead generation phone scraper** workflows, or **telegram database phone numbers** research projects.

***

### 🚀 How to use Telegram 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** section.

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

3. **Fill in the INPUT parameters**\
   In the actor input form, set:
   `keywords` (required), and `country` (required). Optionally add `location` and adjust `maxPhoneNumbers`.

4. **Set Run Options (if you need more time)**\
   Large scraping tasks may take time. You can adjust timeout in **Run Options** (default is 3600s / 1hr).

5. **Run the actor**\
   Click **Run** to start. You’ll see progress and status logs in the run console.

6. **Review the dataset output**\
   When finished, open the **OUTPUT** tab and open the dataset **“Scraped Phone Numbers.”**

7. **Export to your workflow**\
   Export the dataset to JSON or CSV and use it in your CRM, spreadsheet, or analysis pipeline.

No coding required—get **telegram scrape phone numbers** results in minutes.

***

### ⚙️ Advanced features & SEO optimization

- 🧩 **Engineered for “telegram phone number scraper” use cases**: Built to perform automated telegram phone number scraping from Telegram profiles, bios, and post content.
- 🎛️ **Targeting improvements via keywords + country**: Uses your keywords and the selected country option to narrow down extracted numbers for higher relevance (helpful for a telegram phone number finder workflow).
- 💾 **Incremental dataset pushes**: Records are saved as they’re found, so long jobs are safer to run.
- 🔄 **Resilience for large batches**: Includes retries and fallbacks for more consistent behavior when results are limited.

***

### 🧾 Best use cases

- 📈 **Lead generation for outreach teams**: Build targeted lists with telegram phone numbers for marketing based on niche keywords and country focus.
- 🧠 **Market research & audience mapping**: Analyze how different roles (like founders and marketers) present contact details across regions.
- 🏢 **Sales development pipelines**: Feed a telegram contact harvesting tool into CRM enrichment and segmentation workflows.
- 🔎 **Compliance-oriented data audits**: Review publicly available contact data sources and validate country-specific phone formats.
- 💻 **Data analyst enrichment**: Join extracted phone numbers with other datasets for research, dashboards, or cohort analysis.
- 🛠️ **Automation-first research**: Automate a telegram phone number extraction software pipeline to reduce manual collection work.
- 🧾 **Building a reference database**: Create a telegram database phone numbers table for repeated lookups and ongoing discovery.

***

### 🔧 Technical specifications

- **Supported Input Formats**
  - ✅ `keywords` (array of strings)
  - ✅ `location` (string, optional)
  - ✅ `country` (string, required; one of the predefined country options)
  - ✅ `maxPhoneNumbers` (integer, optional; 1–10000, default 20)

- **Proxy Support**
  - ✅ Built-in proxy support for reliable scraping

- **Retry Mechanism**
  - ✅ Includes retries and fallbacks for resilience when results are limited

- **Dataset Structure**
  - ✅ Dataset: **“Telegram Phone Numbers Dataset”**
  - ✅ View: **“Scraped Phone Numbers”** (table with fields: `keyword`, `title`, `description`, `url`, `phone_number`, `country`, `dial_code`)

- **Limitations**
  - ❌ Results depend on publicly available phone numbers present in Telegram profiles, bios, and post content
  - ❌ If you need more results, the actor guidance is to broaden keywords or adjust country settings

***

### ❓ FAQ

#### Can I scrape Telegram phone numbers using only keywords?

✅ Yes. You must provide `keywords`, and you also need a `country` selection. Optional `location` can further refine targeting, but leaving it empty enables a more general (global) search.

#### What types of Telegram content does the actor scan for phone numbers?

✅ Telegram Phone Number Scraper extracts phone numbers from Telegram profiles, bios, and post content using your keywords and country targeting.

#### Why would I get fewer phone numbers than expected?

✅ If results are fewer than expected, the actor’s own guidance is to try broader keywords or different country settings to improve match coverage.

#### What does `maxPhoneNumbers` do?

✅ `maxPhoneNumbers` stops the run after that many phone numbers are found. Higher values can increase scraping duration, so it’s useful for both controlled tests and larger extraction jobs.

#### Is this suitable for a telegram contacts scraper workflow?

✅ Yes. The output is structured and stored incrementally in a dataset, making it easy to export and plug into workflows like telegram contacts scraper pipelines, telegram lead generation phone scraper projects, or CRM enrichment.

#### Do I need to write code to use it?

✅ No. You can run it directly from Apify Console, configure `keywords` and `country`, and then export the dataset once scraping completes.

***

### 🤝 Support & feature requests

Want to improve your **Telegram Phone Number Scraper** results or request enhancements for your telegram phone number scraper script workflow?

💡 **Feature Requests**: Share ideas like adding more export formats, refining how results are filtered, or improving dataset field coverage for downstream analysis.\
📧 **Contact**: For custom scraping needs or support, email us at <dataforleads@gmail.com>.

Your feedback helps shape the roadmap for the Telegram Phone Number Scraper and its telegram scrape phone numbers use cases.

***

### *Telegram Phone Number Scraper* — final thoughts

*If you’re after the most comprehensive, SEO-optimized way to extract phone numbers from Telegram-related public profiles, this Telegram Phone Number Scraper is built for that job.*\
Run it with the right keywords and country targeting, export the dataset, and move faster than manual telegram phone number extraction software workflows.

***

### Disclaimer

**This Telegram Phone Number Scraper accesses publicly accessible sources only.** It does not access private profiles, authenticated data, or password-protected pages.

You are responsible for ensuring your use complies with applicable laws and platform terms, including GDPR, CCPA, spam regulations, and any relevant policies. For data-removal requests, contact <dataforleads@gmail.com>.

Use this tool responsibly, ethically, and for legitimate purposes only.

# 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("scrapers-hub/telegram-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("scrapers-hub/telegram-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 scrapers-hub/telegram-phone-number-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Telegram Phone Number Scraper",
        "description": "📞 Telegram Phone Number Scraper extracts phone numbers from Telegram profiles with speed and precision. 🚀 Perfect for lead generation, sales outreach & market research. 🔍 Save time, target better, grow smarter.",
        "version": "0.1",
        "x-build-id": "9Y58hrtbSu0mDjjH7"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapers-hub~telegram-phone-number-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapers-hub-telegram-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/scrapers-hub~telegram-phone-number-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapers-hub-telegram-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/scrapers-hub~telegram-phone-number-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapers-hub-telegram-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": "Enter keywords to search for (e.g., 'Target Keyword').",
                        "default": [
                            "marketing",
                            "founder"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Filter by location (e.g., 'London', 'California'). Leave empty for global search."
                    },
                    "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": "Select the country to target for phone numbers.",
                        "default": "United Kingdom (+44)"
                    },
                    "maxPhoneNumbers": {
                        "title": "Max Phone Numbers",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Stop scraping after this many phone numbers are found. Setting a higher limit extends the scraping duration.",
                        "default": 20
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
