# Facebook to Phone Number Finder — US Numbers, Pay per Found (`b2bsearch/facebook-to-phone`) Actor

Turn Facebook profiles into phone numbers on record, with LinkedIn profile URL, name, job title and company. A US-centric lookup. Facebook to phone number lookup in bulk from a database, no login. $20 per 1,000 found; misses and people with no phone number on record are free.

- **URL**: https://apify.com/b2bsearch/facebook-to-phone.md
- **Developed by:** [B2B Enrich Search](https://apify.com/b2bsearch) (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 $20.00 / 1,000 phone number founds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Facebook to Phone Number Finder do?

**Facebook to Phone Number Finder** takes a list of Facebook profiles and returns the phone number on
record for the person behind each one, together with their name, job title, current company, location and LinkedIn profile URL.
It is a Facebook to phone number lookup for sales, recruiting and CRM enrichment.

- **One narrow row per entry**: the phone number you asked for and just
  enough of the person's card to recognise them.
- **You pay only when the phone number is found.** A miss, a person with no
  phone number on record, a removed profile and an invalid entry are free
  rows that say why.
- **Up to 1,000 entries per run**, from the form, the API or an MCP client.
- **A database lookup.** Nothing is crawled while your run is in progress,
  and no login, cookies or API key are needed.
- **Contact data, handled plainly.** Numbers are returned as recorded and are not labelled mobile or direct.

### What data do you get from a Facebook profile?

| Field | Example | Notes |
|---|---|---|
| `_status` | `found` | `found`, `no_phone`, `not_found`, `ambiguous`, `profile_removed`, `invalid`, `paused`, `error` |
| `_input` | `{"facebook": "jane.doe"}` | the entry as it was looked up |
| `primaryPhone` | `+15125550142` | the first number on record, as recorded |
| `phones` | `["+15125550142"]` | every number on record |
| `phoneCount` | `1` | numbers on the row |
| `linkedinUrl` | `https://www.linkedin.com/in/jane-doe-example` | on every `found` row |
| `fullName` | `Jane Doe` | when on record |
| `jobTitle`, `company` | `VP Marketing`, `Acme Example` | current role, when on record |
| `location`, `country` | `Austin, Texas, United States`, `US` | when on record |
| `_freshness` | `fresh_90d` | `fresh_90d`, `updated_1y`, `older`, or `unknown` when the record carries no date |
| `_matchCandidates` | `3` | only on `ambiguous` rows |
| `_error` | | a plain sentence on every row that is not `found` |

### How to convert Facebook to phone number (3 steps)

1. Paste your Facebook profiles, one per line.
2. Press **Start** and wait for the run to finish.
3. Export the dataset as CSV, Excel or JSON, or read it through the API.

### How much does Facebook to phone number cost?

| Event | Price | When |
|---|---|---|
| Phone number found | **$0.02** ($20 per 1,000) | the entry resolved to one person and the row carries the phone number |
| Everything else | **$0** | no match, a match with no phone number on record, several people on one Facebook profile, removed profile, invalid entry |

A small per-run start fee may apply; it is shown on the Pricing tab.

### Pay only for what we find — and tell us how we did

You pay only for rows that carry a phone number. Every miss is free and says why, so a test run on your own list costs only what it finds.

If the Actor saved you time, please leave a short review on the **Reviews** tab — it helps other buyers find it, and we read every one. If something looks wrong, open an issue on this Actor and we will fix it.

### Input

```json
{
  "profiles": [
    "https://www.facebook.com/jane.doe",
    "sam.rivera.example"
  ]
}
```

A username or a profile link on facebook.com, m.facebook.com, fb.com or fb.me. The link must carry a **username**: `profile.php?id=…` links, numeric ids, pages and groups name no username and are refused for free instead of being guessed.

### Output

A found row (charged):

```json
{
  "_status": "found",
  "_input": {
    "facebook": "jane.doe"
  },
  "_freshness": "updated_1y",
  "primaryPhone": "+15125550142",
  "phones": [
    "+15125550142"
  ],
  "phoneCount": 1,
  "linkedinUrl": "https://www.linkedin.com/in/jane-doe-example",
  "fullName": "Jane Doe",
  "jobTitle": "VP Marketing",
  "company": "Acme Example",
  "location": "Austin, Texas, United States",
  "country": "US"
}
```

A free row:

```json
{
  "_status": "no_phone",
  "_input": {
    "facebook": "jane.doe"
  },
  "_error": "A person matches this Facebook profile, but no phone number is on record for them. Not charged."
}
```

### Facebook to phone number API, MCP and integrations

Run it from the Apify API, from the Apify MCP server in an AI assistant, or
from Make, n8n and Zapier through their Apify connectors. The input is one
array and the output is one flat row per entry, so it maps onto a
spreadsheet column without reshaping.

### Use cases

- **Sales and RevOps**: add a phone number to leads that arrived with only
  a Facebook profile.
- **Recruiting**: reach a candidate you know only by a Facebook profile.
- **Marketing**: enrich a community, follower or signup list with
  professional context.
- **Developers and AI agents**: one call in, one flat row out.

### FAQ

#### How do I find a phone number from a Facebook profile?

Paste the entry into the input and start the run. If it is on record for
one person and that person has a phone number on record, the row comes back
`found` with it.

#### What is the match rate for Facebook to phone number?

About 20% of usernames resolved in our test sample (8 of 40, 2026-09-30). The sample is small, so treat it as a rough guide. Of the people a Facebook profile resolves to, about 35–45% have a phone number on record. This is a US-centric lookup: 93% of the numbers on record are US (+1) numbers. Your list may do better or worse. Because a lookup
with nothing to return costs nothing, a test run on your own list costs only
what it finds.

#### Am I charged when nothing is found?

No. Every row that is not `found` is free, including a person who matched
but has no phone number on record.

#### What happens when several people share one entry?

We cannot tell which of them you mean, so the row is marked `ambiguous`
with the number of candidates and is not charged.

#### Can I run Facebook to phone number in bulk?

Yes: up to 1,000 entries per run, or send them as a JSON array through the
API and split larger lists into several runs.

#### Does it need cookies, login or an API key?

No. The Actor reads from our own database and never logs in to any network.

#### How fresh is the data?

Each found row carries `_freshness`: `fresh_90d` (record updated within 90
days), `updated_1y`, `older` or `unknown`. People change jobs and contact details;
check before you rely on a row.

#### Is it legal to look up a phone number this way?

That depends on what you do with the result and where you and the person
are. Read "Disclaimer and permitted use" below.

### Use Facebook to Phone Number Finder with AI agents and MCP

This Actor works as a tool for AI agents. Add it to Claude, ChatGPT, Cursor or any other MCP client through the Apify MCP server:

```
https://mcp.apify.com?tools=b2bsearch/facebook-to-phone
```

- **Fast enough for a tool call.** A small request finishes in seconds, so the agent gets its answer inside one call.
- **The agent pays only for results.** Prices are per result (see the pricing section above) and every miss is a free row. Cap what one call may spend with `maxTotalChargeUsd`.
- **Rows explain themselves.** Each row has a `_status`; a row that is not a result says why in `_error`, so the agent can decide what to do next without guessing.

Input an agent can send as is:

```json
{
  "profiles": [
    "https://www.facebook.com/levie"
  ]
}
```

The same Actor is available as a tool in LangChain, CrewAI and the OpenAI Agents SDK, and as a step in n8n, Make and Zapier through the Apify integrations.

### Related Actors: which one should you use?

| Need | Actor |
|---|---|
| Email → LinkedIn profile URL | [Email to LinkedIn](https://apify.com/b2bsearch/email-to-linkedin) |
| Email → current company and job title | [Email to Company](https://apify.com/b2bsearch/email-to-company) |
| Email → phone numbers on record | [Email to Phone](https://apify.com/b2bsearch/email-to-phone) |
| Email → X (Twitter) profile | [Email to Twitter](https://apify.com/b2bsearch/email-to-twitter) |
| Email → Facebook profile | [Email to Facebook](https://apify.com/b2bsearch/email-to-facebook) |
| Email → full professional profile | [Reverse Email Lookup](https://apify.com/b2bsearch/reverse-email-lookup) |
| LinkedIn URL → full profile | [Profile Lookup](https://apify.com/b2bsearch/profile-lookup) |
| LinkedIn URL → email addresses on record | [LinkedIn Email Finder](https://apify.com/b2bsearch/linkedin-email-finder) |
| LinkedIn URL → phone numbers on record | [LinkedIn to Phone](https://apify.com/b2bsearch/linkedin-to-phone) |
| X (Twitter) handle → email | [Twitter to Email](https://apify.com/b2bsearch/twitter-to-email) |
| X (Twitter) handle → LinkedIn profile | [Twitter to LinkedIn](https://apify.com/b2bsearch/twitter-to-linkedin) |
| X (Twitter) handle → phone numbers on record | [Twitter to Phone](https://apify.com/b2bsearch/twitter-to-phone) |
| Facebook profile → email | [Facebook to Email](https://apify.com/b2bsearch/facebook-to-email) |
| Facebook profile → phone numbers on record | **Facebook to Phone** (this Actor) |
| Facebook profile → LinkedIn profile | [Facebook to LinkedIn](https://apify.com/b2bsearch/facebook-to-linkedin) |
| GitHub username → email | [GitHub to Email](https://apify.com/b2bsearch/github-to-email) |
| GitHub username → LinkedIn profile | [GitHub to LinkedIn](https://apify.com/b2bsearch/github-to-linkedin) |
| Name + company domain → work email | [Work Email Finder](https://apify.com/b2bsearch/work-email-finder) |
| Name + company domain → LinkedIn profile | [Name to Profile](https://apify.com/b2bsearch/name-to-profile) |
| Name + company domain → phone numbers on record | [Name to Phone](https://apify.com/b2bsearch/name-to-phone) |
| Handle on any of three networks → full profile | [Social Handle Lookup](https://apify.com/b2bsearch/social-handle-lookup) |
| Company domain → company record | [Domain to Company](https://apify.com/b2bsearch/domain-to-company) |
| Company domain → decision makers | [Decision Maker Finder by Domain](https://apify.com/b2bsearch/domain-to-decision-makers) |
| Company domain → current employees | [Company Employees](https://apify.com/b2bsearch/company-employees) |
| Company domain → former employees | [Former Employees Finder](https://apify.com/b2bsearch/former-employees-finder) |
| Filters → list of people | [People Database Search](https://apify.com/b2bsearch/people-database-search) |
| Filters → list of companies | [Company Database Search](https://apify.com/b2bsearch/company-database-search) |
| CSV of emails, URLs or names → profiles in bulk | [Bulk People Enrichment](https://apify.com/b2bsearch/bulk-people-enrichment) |

### Disclaimer and permitted use

**Independent product.** This Actor is an independent tool. It is not
affiliated with, endorsed by, or sponsored by LinkedIn Corporation or Meta Platforms, Inc. (Facebook).
LinkedIn®, Facebook® are trademarks of their owners and are named here only to describe
the kind of public profile link this Actor accepts or returns.

**No platform access.** This Actor does not log in to or crawl any of these
services. Every answer comes from our own database of business-contact
records. It never returns passwords, direct messages, or content from
accounts that are not public.

**Permitted use.** Business-to-business purposes only: sales prospecting,
recruiting outreach, CRM enrichment, and checking that a business contact
is who they say they are. You may not use this Actor or its output to:

- stalk, harass, threaten, dox or publicly expose any person;
- identify the person behind a pseudonymous or non-professional account;
- decide on anyone's eligibility for credit, employment, housing or
  insurance. This Actor is not a consumer reporting agency and its output
  is not a consumer report under the U.S. Fair Credit Reporting Act;
- send unsolicited bulk messages, or place autodialed or prerecorded calls
  or texts without the consent the law requires;
- profile people by health, religion, political opinion, sexual
  orientation, ethnicity or union membership;
- build or resell a contact database from the results.

**Your responsibilities.** You decide whom to look up and what to do with
the result. You are responsible for having a lawful basis for that use and
for complying with the laws that apply to you, including GDPR and UK GDPR,
ePrivacy and PECR, CCPA/CPRA, CAN-SPAM, and the TCPA and Do Not Call rules.
Honor every opt-out you receive. Phone numbers are returned as recorded; before you call or text a number you are responsible for the U.S. Telephone Consumer Protection Act, the National Do Not Call Registry and the equivalent rules where the person lives.

**Removal requests.** To have a person's data removed, open an issue on
this Actor with only the profile link. Nothing else is needed, and the
record is removed from every listing.

**Accuracy.** Records can be incomplete or out of date. Output is provided
as is. Check it before you rely on it.

# Actor input Schema

## `profiles` (type: `array`):

One Facebook profile per line, up to 1,000 per run. You pay only for rows that come back with the phone number: a match with no phone number on record, a miss, a removed profile and a malformed entry are free rows that say why. This is a US-centric lookup: most numbers on record are US numbers.

## Actor input object example

```json
{
  "profiles": [
    "https://www.facebook.com/levie"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "profiles": [
        "https://www.facebook.com/levie"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("b2bsearch/facebook-to-phone").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 = { "profiles": ["https://www.facebook.com/levie"] }

# Run the Actor and wait for it to finish
run = client.actor("b2bsearch/facebook-to-phone").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "profiles": [
    "https://www.facebook.com/levie"
  ]
}' |
apify call b2bsearch/facebook-to-phone --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,b2bsearch/facebook-to-phone"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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