Contact Details Scraper Actor Documentation

Overview

The Contact Details Scraper is designed to extract contact information from a specified URL. The actor retrieves email addresses, phone numbers, and social media links (e.g., Twitter, LinkedIn, Instagram) associated with the input URL.

---

Features

• Email Extraction: Collect all publicly available email addresses from the provided URL.
• Social Media Links: Retrieve links to associated Twitter, LinkedIn, and Instagram profiles.
• Phone Numbers: Detect and extract phone numbers (if available).
• Customizable Limit: Specify the number of results to retrieve for each category.

---

Use Cases

• Lead Generation: Gather contact details for outreach or marketing campaigns.
• Business Research: Find key contacts for a given website.
• Social Media Management: Identify and connect with associated profiles.
• Customer Support: Collect accessible contact methods for customer assistance.

---

Input Parameters

The actor accepts the following input parameters:

Parameter Name	Type	Description
url	String	The URL to scrape for contact details. Example: https://example.com.
limit	Number	The maximum number of results to return for each category. Default is 10.

Example Input

1const { 
2  url = 'https://example.com', 
3  limit = 10 
4} = input;

---

Output

The actor returns a JSON object containing the extracted contact details.

Example Output

1{
2  "emails": [
3    "oscarterr@example.com",
4    "sauravb@example.com",
5    "olivergon@example.com",
6    "jakubfer@example.com",
7    "mdf@example.com",
8    "ma@example.com",
9    "ka@example.com",
10    "nata@example.com",
11    "jhar@example.com",
12    "vlada_@example.com"
13  ],
14  "phones": [],
15  "twitter": [
16    "https://twitter.com/example"
17  ],
18  "linkedIn": [
19    "https://www.linkedin.com/in/oscar-0b59b448",
20    "https://www.linkedin.com/in/sauainrd",
21    "https://www.linkedin.com/in/lompgrd",
22    "https://www.linkedin.com/in/b4ernan",
23    "https://www.linkedin.com/in/kate-44878891",
24    "https://www.linkedin.com/in/jan-b455647b",
25    "https://linkedin.com/company/apitech"
26  ],
27  "instagram": []
28}

---

How to Use

1. Set Up Input: Provide the URL of the website you wish to scrape and the desired limit for results.
2. Run the Actor: Execute the actor with your input parameters.
3. Analyze Results: Use the extracted contact details for your desired application.

---

FAQs

1. Q: Does this actor only scrape public information?
   A: Yes, it only retrieves information publicly available on the input URL.

2. Q: What if there are no contact details on the page?
   A: The response will include empty arrays for categories without available data.

3. Q: Can I scrape contact details from subpages?
   A: No, this actor is designed to scrape only the main page specified by the input URL.

4. Q: Are the phone numbers extracted in a specific format?
   A: Phone numbers (if available) are extracted in the format they appear on the page.

5. Q: Is it possible to filter by email domain?
   A: No, domain filtering is not currently supported.

6. Q: Can I use this actor to collect bulk data across multiple URLs?
   A: Yes, by running the actor in a batch process, you can collect data from multiple URLs.

7. Q: What happens if the provided limit exceeds the available data?
   A: The actor will return all available data within the specified categories.

8. Q: How reliable are the social media links?
   A: Social media links are directly extracted from the page metadata and content.

---

Benefits

• Time-Saving: Automate the tedious task of manually finding contact details.
• Versatile Output: Use the data for outreach, analysis, or integration into CRM systems.
• Accurate Results: Extract information directly from the source, ensuring up-to-date data.

---

Start streamlining your contact discovery with the Contact Details Scraper! 🚀