# BureauxLocaux Commercial Real Estate Scraper (`manfromgold/bureauxlocaux-com-scraper`) Actor

Extract French commercial property listings from BureauxLocaux.com including offices, warehouses, retail, coworking and land for rent or sale. Returns geo-coded data with surface, price, availability, photos and agency contacts.

- **URL**: https://apify.com/manfromgold/bureauxlocaux-com-scraper.md
- **Developed by:** [Mahmoud Dahab](https://apify.com/manfromgold) (community)
- **Categories:** Real estate, Business, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 results

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

## BureauxLocaux Commercial Real Estate Scraper

Extract French commercial property listings from BureauxLocaux.com including offices, warehouses, retail, coworking and land for rent or sale. Returns geo-coded data with surface, price, availability, photos and agency contacts.

### What data does BureauxLocaux Commercial Real Estate Scraper extract?

| Field | Description |
|---|---|
| `url` | Absolute URL to the listing detail page |
| `propertyType` | office, coworking, warehouse, retail, land |
| `transactionType` | rent or buy |
| `title` | Listing headline |
| `address` | Street address if shown |
| `city` | City name |
| `postalCode` | French postal code |
| `surfaceArea` | Total surface in m² |
| `price` | Monthly rent (€/month) or sale price (€) |
| `charges` | Monthly charges in € (rentals only) |
| `availabilityDate` | ISO 8601 date when available |
| `photos` | Array of absolute photo URLs |
| `agencyName` | Agency or broker name |
| `agencyContact` | Agency phone or contact info |
| `leaseType` | Lease type (bail commercial, bail précaire, etc.) |
| `description` | Short description snippet |

### Use cases

- Proptech platform ingests weekly French office/warehouse comps for automated valuation models
- Tenant-rep brokers monitor new listings matching client criteria in real time
- Retail expansion teams track retail/ground-floor availability in target cities
- Investors build geo-coded lease/sale comparable databases for yield analysis
- Market researchers aggregate supply trends by property type and arrondissement

### How to use it

1. Fill in the input fields (or keep the prefilled example).
2. Set **Max results** to cap the run size and cost.
3. Click **Start** and download results as JSON, CSV, Excel or via the API.

#### Input

| Input | Description |
|---|---|
| `transactionType` | Rent or buy |
| `propertyType` | Type of commercial property |
| `location` | City/department slug from URL (e.g. 'paris-75', 'lyon-69000', 'france' for all) |
| `sortOrder` | Listing sort order |
| `maxItems` | Maximum number of results. |
| `maxPages` | Maximum number of pages to load. |

### Output example

```json
[
  {
    "url": "https://www.bureauxlocaux.com/annonce/immeuble-de-prestige-avec-services-premium--39445527",
    "propertyType": "office",
    "transactionType": "rent",
    "title": "Location Bureaux 1 811 m² à 7 864 m²",
    "address": "86 Boulevard Haussmann",
    "city": "Paris",
    "postalCode": "75008",
    "surfaceArea": 7864,
    "price": 181100,
    "charges": null,
    "availabilityDate": null,
    "photos": [
      "https://imagescdn.bureauxlocaux.com/i2/6rvLByyrSqXJHlwNb4StTfr0g4YnQ2CmG9DSIkuWnR4/117/image.jpg"
    ],
    "agencyName": null,
    "agencyContact": null,
    "leaseType": null,
    "description": "Située au coeur de Paris, cette offre exceptionnelle de bureaux à louer représente une opportunité rare pour les entreprises en quête d'un espace de travail prestigieux et fonctionnel. Avec une superficie totale de 7 864 m², ces bureaux sont divisibles à partir de 1 811 m², permettant ainsi une flexibilité optimale pour répondre aux besoins spécifiques de votre entreprise, qu'elle soit en pleine expansion ou en quête de rationalisation de ses espaces. Nichés dans un quartier dynamique et bien desservi par les transports en commun, ces bureaux bénéficient d'un emplacement stratégique qui facilitera vos déplacements et ceux de vos collaborateurs. L'architecture moderne et élégante de l'immeuble offre un cadre de travail inspirant, propice à la créativité et à la productivité. Les espaces intérieurs, baignés de lumière naturelle grâce à de larges baies vitrées, sont conçus pour maximiser le confort et l'efficacité, avec des aménagements modulables qui s'adaptent à vos besoins. Chaque étage est équipé de toutes les commodités nécessaires, incluant des salles de réunion high-tech, des espaces de détente, et des zones de coworking, favorisant ainsi la collaboration et l'innovation. De plus, la proximité immédiate de nombreux restaurants, cafés, et commerces offre à vos employés un large éventail de choix pour leurs pauses déjeuner ou après le travail, contribuant à un équilibre vie professionnelle-vie personnelle optimal. En choisissant ces bureaux, vous bénéficiez également d'une adresse prestigieuse qui renforcera l'image de marque de votre entreprise auprès de vos clients et partenaires. La sécurité n'est pas en reste, avec un système de surveillance 24/7 et un accès sécurisé, garantissant la tranquillité d'esprit pour vous et vos équipes. Enfin, la gestion écoresponsable de l'immeuble, avec des installations respectueuses de l'environnement, s'inscrit dans une démarche durable, répondant aux attentes des entreprises soucieuses de leur impact écologique. Ne manquez pas cette occasion unique de vous installer dans des bureaux qui allient prestige, fonctionnalité, et flexibilité au coeur de Paris. Contactez-nous dès aujourd'hui pour organiser une visite et découvrir comment cet espace peut devenir le nouveau siège de votre entreprise."
  }
]
```

### Pricing

Pay per result: **$2.00 per 1,000 results**. Platform usage is included. Runs stop at **Max results**, so cost is predictable.

### Is it legal to scrape this site?

This Actor extracts only publicly available, non-personal information from bureauxlocaux.com. It does not log in or bypass access controls. Make sure your use of the data complies with the site's terms and the laws that apply to you.

### Reliability

This Actor is checked automatically several times a day. When the website changes its layout, the extractor is repaired and re-tested against the same output fields, so your integrations keep working.

# Actor input Schema

## `transactionType` (type: `string`):

Rent or buy

## `propertyType` (type: `string`):

Type of commercial property

## `location` (type: `string`):

City/department slug from URL (e.g. 'paris-75', 'lyon-69000', 'france' for all)

## `sortOrder` (type: `string`):

Listing sort order

## `maxItems` (type: `integer`):

Stop after this many results. You are charged per result, so this also caps the cost.

## `maxPages` (type: `integer`):

Maximum number of pages to load (listing pages and pagination).

## `proxyConfiguration` (type: `object`):

Proxies help avoid blocking. Datacenter proxies are enough for most runs.

## `debugSaveHtml` (type: `boolean`):

Store the HTML of the first pages in the key-value store, for troubleshooting.

## Actor input object example

```json
{
  "transactionType": "rent",
  "propertyType": "office",
  "location": "paris-75",
  "sortOrder": "relevance",
  "maxItems": 100,
  "maxPages": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "debugSaveHtml": false
}
```

# Actor output Schema

## `results` (type: `string`):

Records extracted from bureauxlocaux.com, one dataset item each.

# 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 = {
    "location": "paris-75",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("manfromgold/bureauxlocaux-com-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 = {
    "location": "paris-75",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("manfromgold/bureauxlocaux-com-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 '{
  "location": "paris-75",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call manfromgold/bureauxlocaux-com-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,manfromgold/bureauxlocaux-com-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/JGxkyQFJnFuZub2OJ/builds/dxcJJ0hQ1cyf7KJBl/openapi.json