eXp France — advisor directory export

Who it’s for: sales teams, recruiters, and data analysts who need a complete, export-ready list of eXp France advisors with professional contact details and links to public profiles on expfrance.fr.

What you get: one row per advisor — name, email, phone, city and postal code, role label, RSAC / licence fields when present, profile URL and photo URL when the source includes them. No browser — runs read the same public directory the official advisor finder uses, so you get consistent, structured data for CRM or enrichment.

Trust: data reflects what the published directory exposes; use contacts responsibly (see Important below).

---

What you get

Field	Description
sourceId	Advisor id in the upstream directory
externalKey	Secondary public key when present
firstName / lastName	Name
email / phone	Professional contact fields
status	e.g. Active
city / postalCode	Location
jobTitle	Role label when present
licenceNumber / rsacLabel	Compliance fields when present
profileUrl	Public page on expfrance.fr (when a link is present in the source)
photoUrl	Photo URL
recordId	Stable UUID in the directory

Important

• Contact fields are professional data from the public directory. Use them in line with eXp France terms, GDPR, and French marketing rules.
• The Actor relies on the read-only credentials bundled with the public expfrance.fr app. If the provider changes how the directory is exposed, this Actor may need an update — see Internals for technical context.

Quick start (Apify Console)

1. Leave Active advisors only (default) or choose All statuses if you need every row returned by the source.
2. Start the run.
3. Open the Dataset for JSON or Excel export; open Run log in the key-value store to follow progress live.

Input

Field	Default	Description
statusFilter	active	Active advisors only (recommended) or All statuses
maxResults	0	Cap rows (0 = full directory)
pageSize	500	How many advisors are fetched per round trip (50–1000)
concurrency	55	Parallelism when writing rows to the dataset
fetchTimeout	60000	Max wait per request (milliseconds)

{
  "statusFilter": "active",
  "maxResults": 0
}

How it works

1. Loads the France advisor list from the public directory (same origin as the official site).
2. Paginates until the full list is retrieved (or until maxResults is reached).
3. Normalizes each row and pushes it to your Apify dataset.
4. Writes a text RUN_LOG so you can monitor long runs.

Output

• Dataset: one JSON object per advisor.
• RUN_LOG: live text log in the default key-value store.

Sample record

{
  "sourceId": "1002",
  "externalKey": "103133",
  "firstName": "Rudy",
  "lastName": "PLONGEUR",
  "email": "rudy.plongeur@expfrance.fr",
  "phone": "0764013297",
  "status": "Active",
  "city": "Marseille 8ème",
  "postalCode": "13008",
  "jobTitle": "Commercial",
  "licenceNumber": "909527657",
  "rsacLabel": "909527657 Marseille",
  "profileUrl": "https://www.expfrance.fr/fr-rudy-plongeur-103133",
  "photoUrl": "https://img.netty.immo/company54396zsr/assets/nego/1002_l.jpg",
  "countryCode": "FR",
  "recordId": "0a3a9c9a-8292-41d5-bec5-06d6c110cf7c"
}

Local development

npm install
echo '{"statusFilter":"active","maxResults":40}' > input.json
apify run

After a successful local run, output.csv is written next to input.json (semicolon-separated, UTF-8 BOM for Excel).

Support

Contact corentin@outreacher.fr if you need a custom scraper or tailored automation.

Internals

• HTTP requests to the directory REST API (PostgREST-style) with country_code=eq.FR and optional status=eq.Active.
• Pagination uses standard Range headers and total counts from response headers.
• Apify Proxy is enabled by default in the cloud when available.