📞 Contact Phone Extractor – High-Speed B2B Data Engine

This Apify actor extracts business and customer service phone numbers directly from websites with high accuracy and intelligent validation.

It combines contextual filtering, DOM targeting, intelligent contact page discovery, dynamic country detection, and libphonenumber-js validation to identify, normalize, validate, and deduplicate phone numbers while filtering out dates, zip codes, fax numbers, serial numbers, and other false positives.

---

🚀 What It Does

For every website URL provided, the actor extracts:

🏢 Website Overview

• 🌐 Input URL
• 🔗 Resolved Source URL
• 🚦 Extraction Status
• 🗂️ Contact Pages Crawled
• 🧮 Phone Numbers Count

---

📞 Individual Phone Data

For each phone number found:

• 📱 Phone Number
• 📍 Location Found (header, footer, body)
• 🎯 Confidence Score
• 📝 Context Snippet
• 🔗 Source URL
• 🏷️ DOM Subsection

---

⚡ It Handles

• ✅ Multiple website URLs
• 🔄 Automatic URL normalization
• ⚡ High-speed raw HTML scraping
• 🛡️ Anti-blocking capabilities
• 🕵️ Automatic Contact/About page discovery
• 🌍 Dynamic country code detection
• 📞 Phone validation using libphonenumber-js
• 🧹 Cross-page deduplication
• 📊 Context-based confidence scoring
• 🏢 Header, footer, navigation, and body extraction
• 🚫 Filtering of dates, zip codes, fax numbers, and invalid numeric patterns

---

🧠 How It Works

1. Loads website URLs

2. Fetches raw HTML using CheerioCrawler with session rotation and retry handling

3. Scans:

   • Headers
   • Footers
   • Navigation sections
   • Body content

4. Automatically discovers and visits:

   • Contact pages
   • About pages
   • Customer service pages

5. Extracts phone candidates from:

   • Visible text
   • tel: links
   • Structured HTML content

6. Detects country based on website TLD

7. Validates numbers using libphonenumber-js

8. Calculates confidence scores from surrounding context

9. Removes duplicates and low-quality matches

10. Saves structured data to the Apify Dataset

---

⚙️ Input Configuration

Field	Type	Description	Default
startUrls	Array	List of website URLs to scrape	[]
defaultCountryCode	String	Fallback ISO country code	"US"
searchSections	Object	Select sections to scan	{"header":true,"footer":true,"body":false}
deduplicationStrictness	String	Deduplication mode	"balanced"
minPhoneLength	Integer	Minimum digits required	8
maxPhoneLength	Integer	Maximum digits allowed	15
excludePatterns	Array	Regex patterns to exclude	["^800","^888"]
includeOnlyCountryCodes	Array	Allow only specific calling codes	[]
confidenceThreshold	Number	Minimum confidence score	0.5
maxResultsPerUrl	Integer	Maximum phones returned per URL	5
outputFormat	String	Output format	"both"

---

🧩 Example Input

{
  "startUrls": ["https://oberlausitzer-alpakaland.de"],
  "defaultCountryCode": "US",
  "deduplicationStrictness": "balanced",
  "confidenceThreshold": 0.5,
  "excludePatterns": ["^800"],
  "searchSections": {
    "header": true,
    "footer": true,
    "body": false
  }
}

---

📊 Example Output

{
  "originalInputUrl": "https://oberlausitzer-alpakaland.de",
  "source": "https://oberlausitzer-alpakaland.de",
  "contactPagesVisited": [
    "https://oberlausitzer-alpakaland.de/pages/kontakt",
    "https://oberlausitzer-alpakaland.de/policies/contact-information",
    "https://oberlausitzer-alpakaland.de/policies/legal-notice"
  ],
  "status": "Found",
  "phoneNumbersCount": 2,
  "phoneNumbers": [
    {
      "phoneNumber": "+49 35874 20425",
      "formattedVariations": ["035874-20425", "+49 35874 20425"],
      "source": "https://oberlausitzer-alpakaland.de/pages/kontakt",
      "location": "body",
      "subsection": "main-content",
      "confidence": 1,
      "context": "...alb von 24 Stunden., Telefon: 035874-20425 & 035874-223599, Bitte beacht..."
    },
    {
      "phoneNumber": "+49 35874 223599",
      "formattedVariations": [
        "035874-223599",
        "+49 35874 223599",
        "035874223599"
      ],
      "source": "https://oberlausitzer-alpakaland.de/pages/kontakt",
      "location": "body",
      "subsection": "main-content",
      "confidence": 1,
      "context": "...den., Telefon: 035874-20425 & 035874-223599, Bitte beachte, dass wir kein..."
    }
  ]
}

---

If no phone numbers are found:

{
  "originalInputUrl": "www.emiconner.com",
  "source": "http://www.emiconner.com/",
  "status": "No phone numbers found",
  "contactPagesVisited": [],
  "phoneNumbersCount": 0,
  "phoneNumbers": []
}

---

❌ Error Handling

If a website cannot be accessed or processed:

{
  "originalInputUrl": "http://www.jewelrybyARSA.com/",
  "source": "http://www.jewelrybyARSA.com/",
  "status": "Failed",
  "contactPagesVisited": [],
  "error": "Request failed completely (check proxy or rate limits)",
  "phoneNumbersCount": 0,
  "phoneNumbers": []
}

---

🧠 Features

• 📞 Accurate phone number extraction
• ⚡ High-speed HTML-based scraping
• 🛡️ Built-in anti-blocking mechanisms
• 🌍 Dynamic country detection
• 🕵️ Automatic contact page crawling
• 🎯 Confidence-based validation
• 🧹 Automatic deduplication
• 🏢 Targeted DOM extraction
• 📊 Context-aware scoring
• 🚫 False-positive filtering

---

💡 Use Cases

• B2B Lead Generation
• CRM Data Enrichment
• Sales Prospecting
• Business Directory Building
• Contact Database Creation
• Cold Outreach Campaigns
• Business Intelligence Research

---

❓ FAQs

1. Why is it so fast?

The actor downloads and processes raw HTML directly instead of launching a full browser session. Combined with CheerioCrawler, session pooling, and optimized parsing, it delivers high throughput with minimal resource usage.

---

2. Can it extract phone numbers hidden behind buttons or clicks?

No. Since the actor works with raw HTML, it does not execute JavaScript or interact with page elements. It specializes in extracting hardcoded contact information.

---

3. Does it filter Fax numbers?

Yes. The contextual scoring engine heavily penalizes numbers associated with terms such as Fax, Fax:, or F: to prevent them from being returned as primary contact numbers.

---

4. Does it support international phone numbers?

Yes. Dynamic Country Code Detection automatically maps website TLDs (such as .de, .uk, .fr) to their respective countries and validates numbers using libphonenumber-js. A fallback country can also be configured for generic domains.

---

🧑‍💻 Developer Info

Author: codescraper

Email: codescraper011@gmail.com

---

🏷️ Tags

phone-scraper · contact-extractor · lead-generation · b2b-data · phone-number-extractor · data-enrichment · sales-intelligence · web-scraping