# Green-Acres Scraper — French Country Home Listings (`studio-amba/green-acres-scraper`) Actor

Scrape real estate listings from green-acres.fr — the French portal specialized in country homes, longères, manoirs and châteaux for international buyers. Extract price, surface, land size, rooms, energy grade, photos and agency details for any French department. No login required.

- **URL**: https://apify.com/studio-amba/green-acres-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Green-Acres Scraper — French Country Home & Character Property Listings

Scrape real estate listings from [green-acres.fr](https://www.green-acres.fr), the French portal specialized in country homes, longères, manoirs, moulins and châteaux — built specifically for international buyers looking for a second home or a move to rural France. The site publishes 30+ language variants and is one of the main sources agencies use to reach foreign buyers.

This scraper searches by French department and returns structured listing data: price, price per m², living surface, land size, room count, energy grade, photos and agency contact details. No login, no cookies, no browser.

### What you get

- **Prices** in EUR, always forced to EUR regardless of your proxy's exit country (see the currency note below)
- **Property details**: living surface, land surface (hectares converted to m²), room count
- **Location**: city and department, straight from the listing
- **Energy data**: DPE energy grade and greenhouse gas (GES) grade (A–G), when the description states them
- **Photos**: all photo URLs shown on the listing card
- **Agency name and phone number** when the listing displays one
- **Direct URL** to every listing on green-acres.fr

### Use cases

- Market research on French country and character properties
- Price monitoring for a specific department or budget range
- Feeding property data into valuation or relocation-planning tools
- Tracking new listings of a given type (houses, land, castles/manors) across a region
- Building a comparison dataset alongside other French real-estate portals (Bien'ici, SeLoger)

### Input

| Field | Type | Description |
|-------|------|-------------|
| `department` | string | French department, by name (`Dordogne`, `Gironde`, `Alpes-Maritimes`) or INSEE code (`24`, `75`, `2a`). Leave empty for a nationwide search. Default: `Dordogne` |
| `propertyCategory` | string | `all` (default), `house`, `apartment`, `land`, `castle`, or `business` |
| `minPrice` / `maxPrice` | integer | Optional price bounds in EUR |
| `maxResults` | integer | Maximum listings to return. Default: 100 |
| `proxyConfiguration` | object | Proxy settings. Default: Apify automatic proxy |

Example input:

```json
{
    "department": "Dordogne",
    "propertyCategory": "house",
    "maxPrice": 500000,
    "maxResults": 100
}
```

### Output

One dataset item per listing. Real sample from a live run:

```json
{
    "id": "Acak9kzw51yebyyc",
    "title": "Propriété authentiquement périgourdine nichée dans un environnement protégé - Secteur Bergerac / Monpazier",
    "propertyCategory": "all",
    "price": 950000,
    "currency": "EUR",
    "pricePerSqm": 1727,
    "surface": 550,
    "landSurface": 90000,
    "rooms": 12,
    "city": "Beaumont-du-Périgord",
    "department": "Dordogne",
    "energyGrade": "D",
    "gasGrade": "B",
    "description": "Cet ancien moulin, hors d'usage depuis 1910, s'étend sur 9 hectares...",
    "photoCount": 9,
    "photos": [
        "https://lb1.green-acres.com/1452019a/Acak9kzw51yebyyc/miniPhotos/Acak9kzw51yebyyc_1.jpg"
    ],
    "agencyName": "PRESTANT Luxury Realty",
    "phone": "+33 5 25 55 50 73",
    "url": "https://www.green-acres.fr/fr/properties/immobilier/beaumont-du-perigord/Acak9kzw51yebyyc.htm",
    "scrapedAt": "2026-09-11T10:12:00.000Z"
}
```

`landSurface` is always in m² — listings shown in hectares on the site are converted (`9,0 hectares` → `90000`). `energyGrade`/`gasGrade` are `null` when the listing description doesn't state a DPE/GES rating (common on older or private listings). `agencyName` is `null` for a small share of direct/private listings.

### A note on currency

Green-Acres detects the visitor's IP and can silently show prices converted to a different currency (e.g. USD) for non-French exit IPs — same listing, same ID, a different number. This scraper always forces the site's own `currency=EUR` parameter so every price is EUR regardless of which Apify proxy IP the run happens to use. You never need to set a country-specific proxy for correct pricing.

### How to scrape Green-Acres data

1. Open the [Green-Acres Scraper](https://apify.com/jelledesramaults/green-acres-scraper) on Apify
2. Enter a French department (name or code — "Dordogne", "Gironde", "24" all work)
3. Optionally narrow down by property category and price range
4. Set how many listings you want and click **Start**
5. Download the results as JSON, CSV, or Excel from the dataset tab

You can also run it programmatically via the [Apify API](https://docs.apify.com/api/v2) or schedule it to track a department over time:

```bash
curl -X POST "https://api.apify.com/v2/acts/jelledesramaults~green-acres-scraper/runs?token=YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"department": "Gironde", "propertyCategory": "house", "maxResults": 200}'
```

### Large searches

Green-Acres caps each filter combination at 480 displayable results (20 pages of 24). When your search matches more than that, the scraper automatically splits the search into price bands and pages each band separately, deduplicating on listing ID, the same approach used in our Bien'ici scraper. You can request thousands of listings from a single run without doing anything special.

### Cost estimate

This actor is billed $0.005 per run plus $0.002 per result — **1,000 results cost about $2.01**. Usage cost only settles once a run reports **SUCCEEDED** — reading a dataset mid-run will show a cost far below the real total.

### Limitations

- Free-text city search is not supported in this version — only French department (name or INSEE code). A follow-up city-level version is possible if there's demand.
- Overseas French departments (Guadeloupe, Martinique, Réunion, etc.) are not supported — Green-Acres routes them through a separate country picker, not department codes.
- No bedroom count field — the site itself only publishes total room count ("pièces"), not a separate bedroom figure.
- Data is scraped from the public website and may change without notice.
- Respect the website's terms of service and use responsibly.

### Maintained by Studio Amba

We run 700+ scrapers for European websites, and the priority is keeping
every one of them working. Automated runs test this actor against the live
site and verify the output is complete. When the website changes, the
scraper usually gets repaired the same day, without you having to report
anything. Questions and issues go straight to the people who built it, and
most get an answer the same day.

### Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs,
deduplication, delta detection, and delivery to your inbox, Google Sheets,
or API, maintenance included. We can also build a custom version with your
exact fields and filters, or combine multiple sources into one feed.

See [studioamba.dev/services](https://studioamba.dev/services/) or email
<hello@studioamba.dev> for a free data sample.

### Related scrapers

More European real estate scrapers from the same developer:

- [Bien'ici Scraper](https://apify.com/jelledesramaults/bienici-scraper) — French real estate listings from bienici.com
- [SeLoger Scraper](https://apify.com/jelledesramaults/seloger-scraper) — French real estate listings from seloger.com
- [Leboncoin Scraper](https://apify.com/jelledesramaults/leboncoin-scraper) — France's biggest classifieds site
- [Idealista Scraper](https://apify.com/jelledesramaults/idealista-scraper) — Spanish real estate listings
- [Immobiliare.it Scraper](https://apify.com/jelledesramaults/immobiliare-scraper) — Italian real estate listings
- [Immoweb Scraper](https://apify.com/jelledesramaults/immoweb-scraper) — Belgium's #1 property portal

### Support

If something breaks or you need an extra field, open an issue on the [Issues tab](https://apify.com/jelledesramaults/green-acres-scraper/issues). Custom scraper requests are welcome too.

# Actor input Schema

## `department` (type: `string`):

French department to search, by name (e.g. 'Dordogne', 'Gironde', 'Alpes-Maritimes') or INSEE code (e.g. '24', '75', '2a'). Leave empty to search all of France (nationwide, unfiltered). Overseas departments are not supported.

## `propertyCategory` (type: `string`):

Filter by property category. 'All' includes houses, apartments, land, castles/manors and business premises.

## `minPrice` (type: `integer`):

Minimum price in euros.

## `maxPrice` (type: `integer`):

Maximum price in euros.

## `maxResults` (type: `integer`):

Maximum number of listings to return. Searches matching more than 480 listings (the site's own result window per filter) are automatically split into price bands to get around it.

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

Proxy settings. No anti-bot was found on green-acres.fr during recon — automatic proxy is sufficient.

## Actor input object example

```json
{
  "department": "Dordogne",
  "propertyCategory": "all",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "department": "Dordogne",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/green-acres-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 = {
    "department": "Dordogne",
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/green-acres-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 '{
  "department": "Dordogne",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/green-acres-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/green-acres-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/kKpezele1sGx36Ucj/builds/wZuOrakMiIHZ0MiB9/openapi.json