France realty networks — unified agent export

Stop rebuilding the same scrapers for every French network. This Actor pulls published advisor data from major French real estate brands and delivers it in one consistent dataset—ready for CRM import, enrichment tools, or analysis—without maintaining nine separate integrations.

---

Why teams use this

Benefit	What it means for you
One schema everywhere	Same column names (network, sourceKey, names, phones, emails when public, profile URLs, location fields, extra for brand-specific data). No more mapping eight different JSON shapes.
Pick the brand per run	Need eXp this week and IAD the next? Change one input field—no new Actor, no new codebase.
Honest field coverage	Empty cells mean the public site doesn’t show that field, not a broken run. The coverage table below sets expectations per brand.
CRM-friendly export	Structured rows with stable sourceKey values you can dedupe on (network:id). Optional local CSV after apify run (semicolon, UTF-8 BOM).
Faster go-to-market	Lead gen, market mapping, recruiter lists, or partner outreach—focus on outreach, not on fixing selectors for each franchise site.

---

Who it’s for

• Sales & growth teams building prospect lists from public directories (always respect each brand’s terms and GDPR).
• Data & ops who need repeatable runs and a single pipeline into Sheets, Airtable, or a warehouse.
• Agencies & consultants comparing networks for clients—switch network instead of juggling multiple tools.

---

Supported brands (one run = one network)

Choose network in the input:

Value	Brand	Typical use
exp_france	eXp France	Large advisor directory; often includes professional email.
megagence	megAgence	Strong phone + profile coverage; no public email on listings.
lf_immo	LF immo	Directory or targeted profile URLs.
les_portecles	Les Porteclés	Directory or profile URLs.
safti_france	SAFTI France	Full directory scan then profile enrichment.
bsk_immobilier	BSK Immobilier	JSON-backed directory; URL mode for hand-picked profiles.
sextant_france	Sextant France	National map (agents-map.htm) or paste specific URLs; optional social + listing stats.
kw_france	KW France	Full /conseillers list or paste KW profile URLs only.
iad_france	IAD France	Public sitemap + agent JSON API; optional filters via Input JSON (filterRegion, filterPostalCode, listing/review thresholds).

The Console UI is intentionally minimal (Brand only). Power options (maxResults, URL-only modes, etc.) go through Input JSON or the API—see below.

---

Field coverage (public data only)

This Actor reads what each site exposes on public pages. Some brands never show email on the directory; others hide city split in the unified row—use the profile URL in extra / shared columns when needed.

Topic	eXp	megAgence	LF immo	Les Porteclés	SAFTI	BSK	Sextant	KW	IAD
Professional email	Often	Not on public pages	Often on profile	—	Often / heuristic	Often	Often	Often / API+heuristic	Pattern slug@iadfrance.fr (verify before outreach)
Phone	Usually	Usually	Usually	—	Usually	Usually	Usually	Usually	Usually (decoded when API exposes hash)
City / postal	Usually	Usually	See profile	Often	Often	Often	Often	—	Usually
Profile URL	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
RSAC / licence-style	Often	—	—	—	Often	Often	—	—	Often
Lat / lng	—	Often	—	Often	Often	Often	Often (map mode)	—	—

Network-specific identifiers and extras (slugs, RSAC hints, listing counts, etc.) sit under extra so your main columns stay stable.

---

How to run

Apify Console (simplest)

1. Select Brand and start the run.
2. Default behavior for crawl-based networks = full public directory (same idea as the live site’s list or map).
3. Download the Dataset (JSON or export) when the run completes.

Go further (API or Input JSON)

Need	What to pass
Limit rows for a test	"maxResults": 50 (omit or 0 for no cap—within platform limits). IAD France: same key caps sitemap profiles before API fetch.
IAD-only filters	"filterRegion": ["Île-de-France"], "filterPostalCode": "75", filterMinPropertyCount, filterMaxPropertyCount, filterMinReviewsCount (exact region label match for filterRegion)
Profile-only mode (specific URLs, not the full directory)	"directoryMode": "urls" and "profileStartUrls": ["https://…"] — supported for LF immo, Les Porteclés, SAFTI, BSK, KW; Sextant also accepts startUrls / profileStartUrls to switch to URL mode
LF immo legacy keys	lfImmoMode / lfImmoStartUrls still work in raw JSON

The input schema uses additionalProperties: true, so these keys work even when they’re not shown in the form.

Examples

{
  "network": "exp_france",
  "maxResults": 50
}

{
  "network": "megagence",
  "maxResults": 0
}

{
  "network": "kw_france",
  "maxResults": 100,
  "directoryMode": "list"
}

{
  "network": "lf_immo",
  "maxResults": 30,
  "directoryMode": "list"
}

{
  "network": "safti_france",
  "maxResults": 25,
  "directoryMode": "list"
}

---

Output

• Every row: network, sourceKey (network:stable-id), shared fields when available, extra for anything brand-specific.
• Local runs: after apify run, a semicolon CSV (UTF-8 BOM) can be written when the dataset is non-empty—handy for Excel in French locales.

---

Local development

cd fr-realty-agents-hub
npm install
echo '{"network":"megagence","maxResults":5}' > input.json
apify run

---

Compliance & responsibility

Data comes from public pages only. You are responsible for using it in line with each brand’s terms, GDPR, and applicable prospecting rules. This tool does not bypass logins or paywalls.

---

Support & customization

Custom automation, extra networks, or white-label runs:
corentin@outreacher.fr

---

Technical notes (sources)

• eXp France: Supabase REST (public anon key as used by the web app).
• megAgence: JSON search API.
• LF immo / Les Porteclés: HTML directory + Cheerio parsers.
• SAFTI France: __NEXT_DATA__ listing + profile HTML.
• BSK Immobilier: Public agent search JSON API.
• Sextant France: agents-map.htm (Windows-1252); optional fetches for social + listing pages. LinkedIn AI enrichment from the standalone Sextant Actor is not included in this hub.
• KW France: Paginated list + profile HTML + AgentDetail API for emails. LinkedIn AI enrichment from the standalone KW Actor is not included in this hub.