# Côté Particuliers · Advisor Emails & Phones (`corent1robert/cote-particuliers-scraper`) Actor

Export Côté Particuliers agencies and collaborators from public agency sites. Emails, phones and agency details — one row per person. Full France. No login.

- **URL**: https://apify.com/corent1robert/cote-particuliers-scraper.md
- **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community)
- **Categories:** Lead generation, Real estate, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 1,000 advisor with emails

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Côté Particuliers · Full profiles infos (emails, phones)

**Extract comprehensive data from Côté Particuliers agencies and their collaborators** across France. This Actor scrapes the [Côté Particuliers](https://www.coteparticuliers.com/) website to provide you with a complete database of agencies, contact details, and collaborator profiles with emails and phone numbers.

### What does Côté Particuliers Scraper do?

The **Côté Particuliers Scraper** extracts comprehensive data from the Côté Particuliers network, covering all agencies across France. The Actor automatically:

- **Scrapes the main agencies page** to discover all agency URLs from the official Côté Particuliers website
- **Extracts agency information** including name, city, address, postal code, phone, email, and website URL
- **Extracts collaborator information** including full name, email, and phone number from each agency's website
- **Uses optimized extraction** with parallel processing for maximum speed
- **Exports structured data** ready for analysis, CRM integration, or business intelligence

The Actor processes all agencies from the main page and extracts collaborator data from each agency's individual website.

### What can this Côté Particuliers Scraper do?

#### 🚀 Key Features

- **Complete Network Coverage**: Scrapes all Côté Particuliers agencies from the official website
- **Dual Data Extraction**: Extracts both agency-level and collaborator-level information in a single run
- **High Success Rate**: Accurate extraction of collaborator emails and phone numbers
- **Optimized Performance**: Processes multiple agencies in parallel with automatic retry mechanism
- **Complete Contact Data**: Extracts emails, phone numbers, and contact details
- **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 Côté Particuliers Scraper extract?

The Actor extracts comprehensive data from Côté Particuliers agencies and collaborators. Here's what you can extract:

| Data Category | Fields Extracted | Description |
|--------------|------------------|-------------|
| **Agency Information** | `agencyName`, `agencyCity`, `agencyAddress`, `agencyPostalCode`, `agencyPhone`, `agencyEmail`, `agencyWebsite` | Complete agency contact details and location |
| **Collaborator Information** | `collaboratorName`, `collaboratorEmail`, `collaboratorPhone` | Full collaborator profile with contact information |

#### Detailed Field Description

##### Agency Information

- **agencyName**: Name of the agency (e.g., "Côté Particuliers Agen")
- **agencyCity**: City where the agency is located
- **agencyAddress**: Street address of the agency
- **agencyPostalCode**: Postal code (5 digits)
- **agencyPhone**: Phone number of the agency
- **agencyEmail**: Email address of the agency
- **agencyWebsite**: URL of the agency's website

##### Collaborator Information

- **collaboratorName**: Full name of the collaborator
- **collaboratorEmail**: Email address of the collaborator
- **collaboratorPhone**: Phone number of the collaborator

### Input Configuration

The Actor accepts the following input parameters:

```json
{
  "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:

```json
{
  "agencyName": "Côté Particuliers Agen",
  "agencyCity": "Agen",
  "agencyAddress": "15 boulevard de la République",
  "agencyPostalCode": "47000",
  "agencyPhone": "0553863491",
  "agencyEmail": "agen.coteparticuliers@gmail.com",
  "agencyWebsite": "https://agen.coteparticuliers.com",
  "collaboratorName": "LABOUACHRA Lola",
  "collaboratorEmail": "lola.labouachra@gmail.com",
  "collaboratorPhone": "0661423759"
}
```

### Usage

#### Local Development

1. Install dependencies:

```bash
npm install
```

2. Configure input in `input.json`:

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

3. Run the scraper:

```bash
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.coteparticuliers.com/agences` to extract all agency URLs and basic information
2. **Agency Page Scraping**: For each agency, the Actor visits the agency's website to extract collaborator information
3. **Data Extraction**: Uses Cheerio for HTML parsing and extraction
4. **Parallel Processing**: Processes multiple agencies 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 agencies

### Limitations

- The scraper depends on the structure of the Côté Particuliers website
- Some agencies 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.

### Related Actors

These Actors cover the same job or the next step in the workflow. Apify’s automatic recommendations stay inside one category — this list is the rest of the toolkit.

| Actor | Use it when |
|---|---|
| [French Real Estate Agents · Multi-Network CRM & Lead Export](https://apify.com/corent1robert/fr-realty-agents-hub) | French real-estate agents across networks — one CRM file |
| [Efficity Consultants · Full profiles infos (emails, phones)](https://apify.com/corent1robert/efficity-consultants) | Efficity Consultants |
| [Era Immobilier Scraper](https://apify.com/corent1robert/era-immobilier-scraper) | Era Immobilier Scraper |
| [Espaces Atypiques · Full profiles infos (emails, phones)](https://apify.com/corent1robert/espaces-atypiques-agents) | Espaces Atypiques |
| [eXp France Consultants · Full profiles infos (emails, phones)](https://apify.com/corent1robert/exp-france-agents) | eXp France Consultants |
| [Houzz Professional Scraper · Multi-Country Search URLs](https://apify.com/corent1robert/houzz-fr-professionals-scraper) | Houzz Professional Scraper |
| [ORIAS Scraper · French Insurance Broker Leads](https://apify.com/corent1robert/orias-scraper) | French insurance broker leads (ORIAS) |
| [French Companies · Search & SIREN Enrich](https://apify.com/corent1robert/recherche-entreprises-scraper) | French companies: search and SIREN enrich |

# Actor input Schema

## `maxConcurrency` (type: `integer`):

Maximum number of concurrent requests (default: 10). Increase for more speed, decrease to reduce server load.

## `requestTimeout` (type: `integer`):

Maximum timeout for each request in milliseconds (default: 15000 = 15 seconds).

## Actor input object example

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

# Actor output Schema

## `agenciesAndCollaborators` (type: `string`):

Interactive table with all agencies and their collaborators. Filterable and sortable by columns.

## `agenciesOnly` (type: `string`):

List of agencies with their information (one row per agency, without collaborator duplication)

## `collaboratorsOnly` (type: `string`):

Detailed list of all collaborators with their contact information

## `statistics` (type: `string`):

Statistics on extracted data (number of agencies, collaborators, etc.)

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("corent1robert/cote-particuliers-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("corent1robert/cote-particuliers-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call corent1robert/cote-particuliers-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,corent1robert/cote-particuliers-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/nbnvtfiEWbDNRMm4h/builds/k2yF2QmFRE0EPXIb7/openapi.json