# Espaces Atypiques · Full profiles infos (emails, phones) (`corent1robert/espaces-atypiques-agents`) Actor Export Espaces Atypiques team members from public agency pages: names, emails, phones, photos, job titles, and bios. Director vs staff grouping for CRM. Run all French agencies from the sitemap or paste specific agency URLs. No login or API key. - **URL**: https://apify.com/corent1robert/espaces-atypiques-agents.md - **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community) - **Categories:** Developer tools, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $9.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Espaces Atypiques — agency team export **Who it’s for:** sales, recruiters, and analysts who need a **single CRM-ready table** of everyone published on [Espaces Atypiques](https://www.espaces-atypiques.com/) agency “team” pages — **no login**, **no API key** (public website only). **What you get per person:** name, job title, **director vs staff band**, email, phone, photo URL, long biography text, office label, and the **agency page URL** you can cite or revisit. **Rows without an email are not exported** (dataset / CSV), so you only get contactable leads. **Why one Actor:** the site lists **many agencies**; this scraper starts from the **public agency sitemap** (same kind of list search engines use), fetches each French agency page, and reads the team block. You can also **paste a handful of agency URLs** for a quick test or a sub-region. --- ### How to run (Apify Console) 1. Choose **Sitemap** (full France) or **URLs** (your list). 2. Optional: in **Input JSON**, set `maxAgencies` to a small number (e.g. `5`) for a quick test; or pass **`maxResults`** (API) when `maxAgencies` is 0 to mirror the **France realty hub** — sitemap only. Defaults are no cap on agencies and on listing fiches in fallback mode. 3. Start the run; open the **Dataset** or **Run log** when it finishes. --- ### Input | Key | Type | Default | Purpose | |-----|------|---------|---------| | `mode` | `sitemap` \| `urls` | `sitemap` | Full sitemap vs pasted agency pages | | `startUrls` | array of `{ "url": "…" }` | `[]` | French agency page URLs (URLs mode) | | `maxAgencies` | integer | `0` | Sitemap: cap office pages; `0` = use `maxResults` if set, else no cap. URLs: `0` = all pasted URLs; `1+` caps the list. | | `maxResults` | integer | (none) | **API / automation only** (not in Console schema). Sitemap: when `maxAgencies` is `0`, caps how many agency pages to load (same as hub **Max rows**). Ignored in URLs mode. | | `maxListingPages` | integer | `0` | Listings fallback: max `ventes/…` pages per agency (`0` = no cap; `1`–`200` to limit) | | `listingConcurrency` | integer | `6` | Parallel `ventes/…` fetches per agency in fallback | | `concurrency` | integer | `25` | Parallel agency page fetches (bounded) | | `fetchTimeout` | integer | `60000` | Per-request timeout (ms) | | `proxyConfiguration` | object | (Apify) | Optional proxy; same pattern as other Actors on the Apify platform | `additionalProperties: true` — you can pass extra keys from the API if you automate runs. **Example (quick test, Input JSON):** ```json { "mode": "sitemap", "maxAgencies": 5, "concurrency": 10 } ```` **Example (specific agencies):** ```json { "mode": "urls", "startUrls": [{ "url": "https://www.espaces-atypiques.com/paris-rive-gauche/" }], "concurrency": 5 } ``` *** ### Output fields (main) | Field | Meaning | |--------|---------| | `sourceKey` | Stable id (email-based, or path + name if email missing) | | `firstName` / `lastName` / `fullName` | Normalized for export: **prénom** in title case (`fr-FR`), **nom** in **MAJUSCULES**; `fullName` is `Prénom NOM` | | `jobTitle` | Raw line under the name on the site | | `roleCategory` | `director`, `associate_director`, `advisor`, `support`, `other`, `unknown` (heuristic) | | `band` | `director` (management) vs `employee` (includes advisors and unknown titles) | | `isDirector` / `isEmployee` | Booleans derived from `band` | | `email` / `phone` | When shown on the card; **phone** is normalized to `+33 X XX XX XX XX` (French numbers, `0…` → `+33 …`) | | `agencyName` | Office label to use in exports: from the page `h1` when specific; otherwise from the last URL segment (city slug) when the heading is generic (e.g. *Nos collaborateurs*) | | `agencyNameRaw` | First `h1` / header text used before resolution (for debugging) | | `agencyPath` | Path on the site, e.g. `/grand-est/strasbourg/` | | `agencyUrlRegion` | First path segment (area). On single-segment agency URLs (`/blois/`), it is the same slug as the city column so the field is never empty. | | `agencyUrlCitySlug` | Last path segment (city slug as on the site) | | `agencyLabel` | Sub-label on the card (e.g. office name) | | `agencyPageUrl` | Sitemap / input agency URL (stable office id) | | `dataFetchedFrom` | Set when cards were read from `…/collaborateurs/` instead of the home page | | `photoUrl` / `bio` | Image and biography text when present | Role detection uses **French** titles (normalized): e.g. *Directeur d’agence* → director band; *Conseiller* → staff. Titles the parser does not recognise are kept in `jobTitle` and classified as `other`. *** ### Local development ```bash cd espaces-atypiques-agents-scraper npm install echo '{"mode":"sitemap","maxAgencies":2,"concurrency":3}' > input.json apify run --input-file=./input.json ``` If the CLI expects `storage/key_value_stores/default/INPUT.json`, use `--input-file` as above, or add a valid `INPUT.json` that matches the schema. After a run with a non-empty dataset, a **semicolon CSV** (UTF-8 BOM) is written to `output.csv` in the project root. Rows are **sorted** by agency path, then last name, first name, email. Columns are **fixed** (no dynamic `Extra:` fields); `sourceKey` is the last column; `roleCategory` remains on the **dataset** record but is omitted from the CSV to avoid overlap with `band` / `jobTitle`. *** ### How it works (technical) 1. **Sitemap mode:** `GET /sitemap_index.xml` → find `agence-sitemap.xml` → `GET` that file → keep `` URLs that are **not** under `/en/` (French pages only). 2. **Fetch** each **agency home** page (bounded concurrency, retries; redirects are followed). 3. **Parse the team** from `.preview-collaborateur` (prefer `#equipe-trombi`) when a `mailto` is present. 4. If the home page has **no** team block, **do not** call `/collaborateurs/` (it often redirects to a national page). Instead, collect `ventes/…` URLs from the home grid (**`#annonces-localisations`**, **`#biens`**, **`.biens-localisation`**) **and** from the CTA that points to **`/ventes/?pl=…`** (hidden `pl` in the form): the Actor follows **paginated** search results (`/ventes/page/2/?pl=…`, etc.) until it has enough links or there is no next page. Then it opens each listing and parses the **negotiator** card (name, phone, email — including `mailto` in HTML comments). Total opened listings are capped by **`maxListingPages`** (default **`0`** = no cap; set **`1`–`200`** to limit each office — useful for smoke tests). Large full runs use more time and Apify resources. Internal safety still stops after many WordPress list pages per `pl` filter. **`listingConcurrency`** controls parallel listing fetches per agency. 5. **Dedupe** rows by `sourceKey` (email) and push to the default dataset. `agencyPageUrl` is always the sitemap office URL; `dataFetchedFrom` points at the listing URL when the row came from the listings fallback. *** ### Compliance Data is taken from **public** pages. You are responsible for using it in line with applicable law, the site’s terms, and **GDPR** (prospecting rules, contact preferences). *** ### Support & custom work # Actor input Schema ## `mode` (type: `string`): Sitemap: every French agency page from the site map. URLs: only the agency pages you paste. ## `startUrls` (type: `array`): Paste full agency URLs (French site, not /en/). Example: https://www.espaces-atypiques.com/paris-rive-gauche/ — URLs mode only. ## `maxAgencies` (type: `integer`): 0 = no cap (all agencies from the sitemap). Set 3–10 for a quick test run only. ## `concurrency` (type: `integer`): How many agency pages can load and parse at the same time. ## `fetchTimeout` (type: `integer`): Maximum wait for each page before retry or skip. ## `maxListingPages` (type: `integer`): When the home page has no team block, cap how many ventes/ detail pages to open (after merging the home grid + /ventes/?pl=… search pages). 0 = no cap (all discoverable fiches, with internal pagination safety). Set 1–200 only to limit each office. ## `listingConcurrency` (type: `integer`): Parallel fetches for ventes/ pages when using the listings fallback (per agency). ## Actor input object example ```json { "mode": "sitemap", "startUrls": [ { "url": "https://www.espaces-atypiques.com/paris-rive-gauche/" } ], "maxAgencies": 0, "concurrency": 25, "fetchTimeout": 60000, "maxListingPages": 0, "listingConcurrency": 6 } ``` # Actor output Schema ## `dataset` (type: `string`): All people as JSON — open the Dataset tab or export. ## `overview` (type: `string`): Slim columns for quick review. ## `runLog` (type: `string`): Progress while listing and saving rows. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.espaces-atypiques.com/paris-rive-gauche/" } ], "maxAgencies": 0, "maxListingPages": 0 }; // Run the Actor and wait for it to finish const run = await client.actor("corent1robert/espaces-atypiques-agents").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.espaces-atypiques.com/paris-rive-gauche/" }], "maxAgencies": 0, "maxListingPages": 0, } # Run the Actor and wait for it to finish run = client.actor("corent1robert/espaces-atypiques-agents").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.espaces-atypiques.com/paris-rive-gauche/" } ], "maxAgencies": 0, "maxListingPages": 0 }' | apify call corent1robert/espaces-atypiques-agents --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=corent1robert/espaces-atypiques-agents", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Espaces Atypiques · Full profiles infos (emails, phones)", "description": "Export Espaces Atypiques team members from public agency pages: names, emails, phones, photos, job titles, and bios. Director vs staff grouping for CRM. Run all French agencies from the sitemap or paste specific agency URLs. No login or API key.", "version": "1.12", "x-build-id": "SfQU1rdNVz0vXJCEJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corent1robert~espaces-atypiques-agents/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corent1robert-espaces-atypiques-agents", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/corent1robert~espaces-atypiques-agents/runs": { "post": { "operationId": "runs-sync-corent1robert-espaces-atypiques-agents", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/corent1robert~espaces-atypiques-agents/run-sync": { "post": { "operationId": "run-sync-corent1robert-espaces-atypiques-agents", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "sitemap", "urls" ], "type": "string", "description": "Sitemap: every French agency page from the site map. URLs: only the agency pages you paste.", "default": "sitemap" }, "startUrls": { "title": "Agency page URLs", "type": "array", "description": "Paste full agency URLs (French site, not /en/). Example: https://www.espaces-atypiques.com/paris-rive-gauche/ — URLs mode only.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxAgencies": { "title": "Max agency pages", "minimum": 0, "type": "integer", "description": "0 = no cap (all agencies from the sitemap). Set 3–10 for a quick test run only.", "default": 0 }, "concurrency": { "title": "Page parallelism", "minimum": 3, "maximum": 80, "type": "integer", "description": "How many agency pages can load and parse at the same time.", "default": 25 }, "fetchTimeout": { "title": "Request timeout (ms)", "minimum": 15000, "type": "integer", "description": "Maximum wait for each page before retry or skip.", "default": 60000 }, "maxListingPages": { "title": "Max property pages per agency (fallback)", "minimum": 0, "maximum": 200, "type": "integer", "description": "When the home page has no team block, cap how many ventes/ detail pages to open (after merging the home grid + /ventes/?pl=… search pages). 0 = no cap (all discoverable fiches, with internal pagination safety). Set 1–200 only to limit each office.", "default": 0 }, "listingConcurrency": { "title": "Listing page parallelism", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel fetches for ventes/ pages when using the listings fallback (per agency).", "default": 6 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```