# Website Email Phone Extractor

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/website/email_phone_extractor` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/website-email_phone_extractor |

## Description

Extract emails and phone numbers from websites for comprehensive contact details, including social media profiles across 12+ platforms.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/website/email_phone_extractor' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Extract contacts from hexa.cc

```json
{
  "emails": [
    "love@hexa.com"
  ],
  "contact_pages": [],
  "phone_numbers": [],
  "reddit_profiles": [],
  "tiktok_profiles": [],
  "twitter_profiles": [
    "https://x.com/joinhexa"
  ],
  "youtube_channels": [],
  "facebook_profiles": [],
  "linkedin_profiles": [
    "https://www.linkedin.com/company/joinhexa/"
  ],
  "snapchat_profiles": [],
  "telegram_channels": [],
  "instagram_profiles": [
    "https://www.instagram.com/joinhexa/"
  ],
  "pinterest_profiles": [],
  "crunchbase_profiles": []
}
```

### Extract contacts from piloterr.com (country_code=FR)

```json
{
  "emails": [],
  "contact_pages": [
    "https://www.piloterr.com/contact"
  ],
  "phone_numbers": [],
  "reddit_profiles": [],
  "tiktok_profiles": [],
  "twitter_profiles": [],
  "youtube_channels": [],
  "facebook_profiles": [],
  "linkedin_profiles": [],
  "snapchat_profiles": [],
  "telegram_channels": [],
  "instagram_profiles": [],
  "pinterest_profiles": [],
  "crunchbase_profiles": []
}
```

### Extract contacts from stripe.com (country_code=US)

```json
{
  "emails": [],
  "contact_pages": [
    "https://stripe.com/en-fr/contact/sales"
  ],
  "phone_numbers": [],
  "reddit_profiles": [],
  "tiktok_profiles": [],
  "twitter_profiles": [],
  "youtube_channels": [],
  "facebook_profiles": [],
  "linkedin_profiles": [],
  "snapchat_profiles": [],
  "telegram_channels": [],
  "instagram_profiles": [],
  "pinterest_profiles": [],
  "crunchbase_profiles": []
}
```

## Documentation

## Overview
The Website Email Phone Extractor API crawls any public website and extracts all contact information it finds, including email addresses, phone numbers (with real-time validation), and social media profiles across 12+ platforms. The crawler follows internal links to discover contact pages automatically.

## Quickstart
```
GET https://api.piloterr.com/v2/website/email_phone_extractor?query=https://www.hexa.cc&country_code=FR
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | A website URL with the `http://` or `https://` protocol |
| `country_code` | string | no | ISO 3166-1 alpha-2 country code to improve phone number validation accuracy |

## Response fields
| Field | Type | Description |
|---|---|---|
| `emails` | array | List of email addresses found on the website |
| `phone_numbers` | array | List of validated phone number objects |
| `phone_numbers[].e164` | string | Phone number in E.164 international format |
| `phone_numbers[].local` | string | Phone number in local format |
| `phone_numbers[].valid` | boolean | Whether the phone number passed validation |
| `phone_numbers[].country` | string | Detected country code of the phone number |
| `contact_pages` | array | URLs of contact pages discovered on the site |
| `linkedin_profiles` | array | LinkedIn profile or company page URLs |
| `twitter_profiles` | array | Twitter/X profile URLs |
| `instagram_profiles` | array | Instagram profile URLs |
| `facebook_profiles` | array | Facebook page URLs |
| `tiktok_profiles` | array | TikTok profile URLs |
| `youtube_channels` | array | YouTube channel URLs |
| `reddit_profiles` | array | Reddit profile URLs |
| `telegram_channels` | array | Telegram channel URLs |
| `crunchbase_profiles` | array | Crunchbase company profile URLs |

## Notes
- Results may contain personal data protected by GDPR or other privacy regulations
- The `country_code` parameter significantly improves phone number parsing accuracy
- The crawler follows anchor links to discover contact pages automatically

## Main use cases
- Build outreach lists by extracting verified email addresses and social handles from company websites
- Enrich CRM records with contact information scraped directly from target company pages
- Validate and normalize international phone numbers from prospect websites for sales teams
- Automate lead qualification by identifying which social platforms a company is active on