Keymex Scraper - Extract Center and Collaborator Data

Extract comprehensive data from Keymex centers and their collaborators across France. This Actor scrapes the Keymex website to provide you with a complete database of centers, contact details, and collaborator profiles with emails, phone numbers, and professional information.

What does Keymex Scraper do?

The Keymex Scraper extracts comprehensive data from the Keymex network, covering all centers across France. The Actor automatically:

• Scrapes the main centers page to discover all center URLs from the official Keymex website
• Extracts center information including name, city, address, postal code, phone, and website URL
• Extracts collaborator information including full name, job title, email, phone number, and photo from each center's website
• Uses JSON-LD structured data for accurate extraction of collaborator details
• Uses optimized extraction with parallel processing for maximum speed
• Exports structured data ready for analysis, CRM integration, or business intelligence

The Actor processes all centers from the main page, extracts collaborator URLs from each center page, and then extracts detailed information from each collaborator's individual page using JSON-LD structured data.

What can this Keymex Scraper do?

🚀 Key Features

• Complete Network Coverage: Scrapes all Keymex centers from the official website
• Dual Data Extraction: Extracts both center-level and collaborator-level information in a single run
• JSON-LD Parsing: Uses structured data (JSON-LD) for accurate extraction of collaborator details
• High Success Rate: Accurate extraction of collaborator emails, phone numbers, and job titles
• Optimized Performance: Processes multiple centers in parallel with automatic retry mechanism
• Complete Contact Data: Extracts emails, phone numbers, photos, and job titles
• Structured Output: Clean, normalized data ready for immediate use

🎯 Platform Advantages

Your Actor + the Apify platform. They come as a package. This scraper benefits from:

• Monitoring & Logs: Real-time execution monitoring with detailed logs
• API Access: Access your data programmatically via Apify API
• Scheduling: Set up automated runs on a schedule
• Integrations: Connect to Make.com, Zapier, Google Sheets, and more
• Proxy Rotation: Automatic proxy management for reliable scraping
• Scalability: Handle large-scale scraping with cloud infrastructure
• Data Storage: Secure dataset storage with multiple export formats (JSON, CSV, Excel, HTML)

What data can Keymex Scraper extract?

The Actor extracts comprehensive data from Keymex centers and collaborators. Here's what you can extract:

Data Category	Fields Extracted	Description
Center Information	centerName, centerCity, centerAddress, centerPostalCode, centerPhone, centerWebsite	Complete center contact details and location
Collaborator Information	collaboratorName, collaboratorFirstName, collaboratorLastName, collaboratorJobTitle, collaboratorEmail, collaboratorPhone, collaboratorPhoto, collaboratorUrl	Full collaborator profile with contact information

Detailed Field Description

Center Information

• centerName: Name of the center (e.g., "KEYMEX Ambitions Toulon Var")
• centerCity: City where the center is located
• centerAddress: Street address of the center
• centerPostalCode: Postal code (5 digits)
• centerPhone: Phone number of the center
• centerWebsite: URL of the center's website

Collaborator Information

• collaboratorName: Full name of the collaborator
• collaboratorFirstName: First name of the collaborator
• collaboratorLastName: Last name of the collaborator
• collaboratorJobTitle: Job title (e.g., "Agent commercial")
• collaboratorEmail: Email address of the collaborator
• collaboratorPhone: Phone number of the collaborator
• collaboratorPhoto: URL of the collaborator's photo
• collaboratorUrl: URL of the collaborator's page

Input Configuration

The Actor accepts the following input parameters:

{
  "maxConcurrency": 10,
  "requestTimeout": 15000
}

Input Parameters

• maxConcurrency (number, optional): Maximum number of concurrent requests. Default: 10
• requestTimeout (number, optional): Request timeout in milliseconds. Default: 15000 (15 seconds)

Output Format

The Actor outputs data in the following format:

{
  "centerName": "KEYMEX Ambitions Toulon Var",
  "centerCity": "Toulon Var",
  "centerAddress": "1110 Chemin des plantades, Centre d'Affaires Grand Var - Bâtiment B, 83130 La Garde",
  "centerPostalCode": "83130",
  "centerPhone": "0422146808",
  "centerWebsite": "https://www.keymex.fr/agence-immobiliere/toulon-var/",
  "collaboratorName": "CLOUET Dimitri",
  "collaboratorFirstName": "Dimitri",
  "collaboratorLastName": "CLOUET",
  "collaboratorJobTitle": "Agent commercial",
  "collaboratorEmail": "dimitri.clouet@keymex.fr",
  "collaboratorPhone": "0630028755",
  "collaboratorPhoto": "https://v2.immo-facile.com/office8/keymex_2207130928/catalog/images/members/855274.jpg",
  "collaboratorUrl": "https://www.keymex.fr/agence-immobiliere/toulon-var/855274/"
}

Usage

Local Development

1. Install dependencies:

$npm install

2. Configure input in input.json:

{
  "maxConcurrency": 10,
  "requestTimeout": 15000
}

3. Run the scraper:

$npm start

4. Results will be saved to:
   • output.csv - CSV file with all extracted data
   • storage/datasets/default/ - Apify dataset (JSON format)

Apify Platform

1. Upload the Actor to Apify
2. Configure input parameters in the Actor's input
3. Run the Actor
4. Download results from the Actor's dataset

Technical Details

Extraction Process

1. Main Page Scraping: The Actor first scrapes https://www.keymex.fr/agence-immobiliere/ to extract all center URLs and basic information
2. Center Page Scraping: For each center, the Actor visits the center's website to extract collaborator URLs from the team section
3. Collaborator Page Scraping: For each collaborator, the Actor visits the collaborator's individual page to extract detailed information from JSON-LD structured data
4. Data Extraction: Uses Cheerio for HTML parsing and JSON-LD parsing for structured data extraction
5. Parallel Processing: Processes multiple centers simultaneously for optimal performance

Error Handling

• Automatic retry mechanism for failed requests
• Timeout handling for slow-loading pages
• Graceful error handling that continues processing other centers
• Fallback to HTML extraction if JSON-LD is not available

Limitations

• The scraper depends on the structure of the Keymex website
• Some centers may not have collaborator information publicly available
• Rate limiting may apply if scraping too aggressively

Support

For issues, questions, or contributions, please refer to the project repository.