# 📱 Phone Number Lookup - Carrier, Line Type & E.164 Validator (`unrivaled_fortress/phone-lookup`) Actor

Phone number validator, carrier checker and line type lookup. Validate, parse and enrich numbers with country, carrier, line type (mobile, landline, VoIP), timezone and E.164 formatting. Bulk phone list cleaning for CRM, SMS and leads. No API key required… Try free — no API key, instant results.

- **URL**: https://apify.com/unrivaled\_fortress/phone-lookup.md
- **Developed by:** [David An](https://apify.com/unrivaled_fortress) (community)
- **Categories:** Other, Lead generation
- **Stats:** 5 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## 📱 Phone Number Lookup - Carrier, Country & Line Type

**Validate, parse, and enrich phone numbers at scale.** Get country, carrier, line type (mobile/landline/VoIP), timezone and E.164 formatting — no API key required.

### ✨ Features

- 🌍 **123+ countries** with carrier and line type detection
- 📞 **Line type detection**: mobile, landline, VoIP/toll-free
- 🏢 **Carrier identification** for US (Verizon/AT\&T/T-Mobile), UK (EE/O2/Vodafone/Three), EU (Orange/SFR/Telekom/Vodafone/TIM/Telefonica), and more
- ⏰ **Timezone mapping** per country
- 🔢 **E.164 formatting** with national format variants
- 🚫 **No API key** — works offline, fast, no rate limits
- 📊 Export as JSON / CSV / Excel

### 📥 Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `phones` | string | — | Phone numbers, one per line (with or without +) |
| `maxResults` | integer | 100 | Max numbers to process |

### 📤 Output

Each dataset item contains: `input`, `valid`, `normalized`, `formatted`, `country`, `countryCode`, `iso2`, `region`, `lineType`, `carrier`, `timezone`, `nationalLength`.

### 💡 Use Cases

- **Lead generation**: clean CRM lists, verify phone numbers before outreach
- **Fraud prevention**: detect VoIP/burner numbers
- **SMS marketing**: identify mobile numbers for campaigns
- **Data enrichment**: add country + carrier to existing contacts

### 💰 Pricing

**from $1.50 / 1,000 results** — pay only for valid data returned.

### ⭐ Reviews

Used this Actor? Please leave a rating — it helps other users and supports continued development.

***

**Crafted by [David Ahn](https://apify.com/unrivaled_fortress)** · Built with [Apify](https://apify.com) + [Crawlee](https://crawlee.dev) (open-source)

### ⭐ Leave a Review

**Your rating helps this Actor reach more users.** A 30-second review on the Apify Store makes a real difference for indie developers.

### 📌 Changelog

- **v1.0** — Public release
- **v1.1** — Added more output fields and clearer error messages
- **v1.2** — Performance and reliability improvements

### 🔧 Support

Issues or feature requests? Open an issue directly on this Actor's *Issues* tab — average response time: under 24h.

***

**Crafted by [David Ahn](https://apify.com/unrivaled_fortress)** · Built with [Apify](https://apify.com) + [Crawlee](https://crawlee.dev) (open-source)

# Actor input Schema

## `phones` (type: `string`):

Enter phone numbers in international format (e.g. +141\*\*\*\*2671). One per line. Max 1000 per run.

## `maxResults` (type: `integer`):

Maximum number of results

## Actor input object example

```json
{
  "phones": "+141****2671",
  "maxResults": 100
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("unrivaled_fortress/phone-lookup").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("unrivaled_fortress/phone-lookup").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 '{}' |
apify call unrivaled_fortress/phone-lookup --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/diRRJe93naJq3Zmgb/builds/9bCKdXZdns0vxtnC6/openapi.json