Email and Phone Number Scraper

An Apify Actor template for scraping contact information from a single web page. It's built with Python and designed for lead generation and automation tasks. You provide a URL, and the Actor extracts email addresses and phone numbers found in the HTML, saving the results to a structured dataset.

Overview

This Actor is a starting point for scraping contact data. It uses HTTPX to fetch a webpage and Beautiful Soup to parse the HTML, searching for patterns that match email addresses and phone numbers. The scraped data is stored in an Apify dataset for easy access and integration. You can modify the parsing logic to target different data or adjust the search patterns.

Key Features

• Apify SDK for Python: Toolkit for building and running Actors on the Apify platform.
• Input Schema: Validates input configuration, such as the target URL.
• Structured Output: Stores results in a dataset where each item contains the extracted emails and phone numbers.
• HTTPX: Handles asynchronous HTTP requests to fetch page content efficiently.
• Beautiful Soup: Parses HTML to find and extract the target data.

Input/Output

Input (via Actor.get_input())
The primary input is a url (string) pointing to the webpage to scrape. The input schema can be extended to include additional parameters like custom regex patterns.

Output (via Actor.push_data() and dataset)
The Actor outputs items to a dataset. Each item typically contains:
* url: The source page.
* emails: A list of email addresses found.
* phones: A list of phone numbers found.

Example dataset item:

{
  "url": "https://example.com/contact",
  "emails": ["contact@example.com", "support@example.com"],
  "phones": ["+1-555-123-4567", "(555) 987-6543"]
}

How to Use

1. Configure Input: In the Actor's input, set the url field to the webpage you want to scrape.
2. Run the Actor: Start the run. The Actor will:
   • Fetch the HTML from the provided URL using httpx.AsyncClient().get(url).
   • Parse the content with BeautifulSoup(response.content, 'lxml').
   • Extract data using search patterns for emails and phone numbers.
   • Save the structured results to the run's dataset.
3. Access Results: Retrieve the data from the dataset via the Apify console, API, or integrations.

Local Development

To develop locally, use the Apify CLI to pull the Actor code:

1. Install the CLI:
   bash npm -g install apify-cli
   or
   bash brew install apify-cli

2. Pull the Actor using its unique name or ID:
   bash apify pull <ActorId>

Resources

• Apify SDK for Python documentation
• Beautiful Soup documentation
• Apify Platform documentation
• Python tutorials in Academy