Efficity Consultants Scraper

Export Efficity independent real estate consultants (mandataires) from the public directory at efficity.com/consultants-immobiliers. You get export-ready rows: names, phones, emails, coverage hints, Immodvisor signals, specialties, services, and full presentation text — for CRM, prospecting, or market mapping.

Built for: Lead lists · Territory mapping · CRM enrichment · Market research

Custom automation or integrations: corentin@outreacher.fr

---

What does it do?

Mode	What you get	Best for
Full directory	Every consultant discovered on the public annuaire (cities, departments, regions), then one row per profile	National or large-scale export
URLs	Only the profile pages you paste	Refreshing or enriching an existing list

The site serves HTML in the first response; this Actor uses HTTP + Cheerio (no browser). Emails hidden behind Cloudflare are decoded when data-cfemail is present.

---

How it works

1. Full directory: Load the national consultants index, collect every listing URL (v_ / d_ / r_), then fetch listing pages with a bounded worker pool (your Directory parallelism input, default 40). As soon as one request finishes, the next URL starts — better throughput than waiting for a whole batch to finish. Slugs are deduplicated as pages are processed.
2. URLs: Parse your efficity.com/{slug}/ links into slugs (duplicates removed).
3. Profiles: Same pool pattern for profile URLs (Profile parallelism, default 55). Each slot runs fetch → Cheerio parse → pushData so rows appear in the dataset while the run is still downloading other profiles.
4. Local only: After a successful run, write output.csv next to the project (UTF-8 BOM, ; separator) for Excel.

---

Output fields

Category	Fields
Identity	slug, displayName, headline, subtitle
Geography	ville, departement (from page analytics when present)
Contact	phones, email, profileUrl, photoUrl
Trust / ratings	immodvisorRating, immodvisorUrl, immodvisorRecommendations
Offer	specialties, services
Copy	aboutBrief, aboutFull, metaDescription, ogDescription
Local context	priceM2Estimate (m² price band when shown on the profile)

Use the Dataset view Consultants — Overview for a slim table; the default dataset contains full rows.

---

Sample output (one consultant)

{
  "slug": "apoisneau",
  "profileUrl": "https://www.efficity.com/apoisneau/",
  "displayName": "Alexandre POISNEAU",
  "subtitle": "Votre Consultant immobilier à Bruz",
  "ville": "Bruz",
  "departement": "35",
  "phones": ["+33 6 61 96 67 65"],
  "email": "apoisneau@efficity.com",
  "specialties": ["Immobilier ancien", "Location"],
  "services": ["Estimation offerte sur place", "Accompagnement personnalisé"]
}

---

Run log and status

• Console / Apify log: Phase banners (====), progress lines, counts, and duration — English only.
• RUN_LOG: The same lines are written to the default key-value store as RUN_LOG (text) so you can follow progress while the run is active.
• Run page: On Apify Cloud, short status messages describe the current phase (listing, fetching profiles, done).

---

Quick start (Apify Console)

1. Create a run and choose Full directory or URLs.
2. For URLs, paste profile links such as https://www.efficity.com/apoisneau/.
3. Optional: set Max consultants to a small number for a trial (Full directory only).
4. Open Dataset for JSON/CSV export, or Key-value store → RUN_LOG for live text progress.

---

Input examples

Full directory (no cap):

{
  "mode": "list"
}

Full directory — first 50 consultants after listing:

{
  "mode": "list",
  "maxResults": 50
}

Specific profiles:

{
  "mode": "urls",
  "startUrls": [
    { "url": "https://www.efficity.com/apoisneau/" },
    { "url": "https://www.efficity.com/gbrossaud/" }
  ]
}

---

Input parameters

Parameter	Type	Default	Description
mode	string	list	list (full directory) or urls (your links only)
startUrls	array	[]	Consultant profile URLs (urls mode)
maxResults	integer	0	Max consultants after listing (0 = no limit)
concurrency	integer	55	Max concurrent profile pipelines (fetch + parse + dataset push)
listConcurrency	integer	40	Max concurrent directory pages (list mode)
fetchTimeout	integer	45000	Per-request timeout (ms)

---

Local development

npm install
npm test
apify run

• input.json in the project folder is merged with Console/API input (cloud input wins when both apply).
• Results: storage/datasets/default/ (JSON items).
• output.csv is written at the project root after a successful local run (fixed column order; lists joined with |; see How it works).

---

Important

• Terms and law: Use scraped data in line with Efficity’s terms and applicable privacy law (e.g. GDPR for personal data).
• Immodvisor: Links on a profile may point to network-level Immodvisor pages; values are exported as shown on the site.
• Full runs: A national export issues hundreds of directory requests plus one request per consultant; default timeout and memory are set for long runs (see actor.json). If the site throttles or returns errors, lower Directory parallelism and Profile parallelism (defaults 40 / 55; caps 80 / 100). Progress ETA stabilizes after the first ~20 profiles (early estimates can be noisy).

---

Support

Contact corentin@outreacher.fr for bespoke scraping, scheduling, or CRM connectors.