Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Green-Acres

1 credit per call4 endpoints20 datapoints

Green-Acres API

Green-Acres API for property search, listings, agencies and location autocomplete as JSON, with houses, castles, land and more. 1 credit per successful call.

Get a free API keyRun it below
Green-Acres
GET/v1/green-acres/search?location=dp_07&property_type=house&sort=price_asc&price_max=400000&bedrooms_min=3
{
  "success": true,
  "data": {
    "items": [
      {
        "listing_id": "Antv5yleb73gh6b9",
        "url": "https://www.green-acres.fr/fr/properties/immobilier/saint-alban-auriolles/Antv5yleb73gh6b9.htm",
        "title": "Au cœur de Saint-Alban-Auriolles, une âme de pierre vous attend",
        "price": 88000,
        "currency": "EUR",
        "price_on_request": false,
        "price_from": false,
        "price_per_m2": 727,
        "city": "Saint-Alban-Auriolles",
        "department": "Ardèche",
        "property_type": "Villa",
        "is_new_build": false,
        "is_exclusive": true,
        "rooms": 4,
        "bedrooms": 3,
        "living_area_m2": 121,
        "description_snippet": "EXCLUSIVITE TOURRE IMMOBILIER Telle une gardienne silencieuse du passé, cette maison ardéchoise murmure encore les histoires d’un temps révolu. Dominant le parvis de l’église, elle s’impose avec grâce, noble et discrète, dès que vous en fra…",
        "photo_count": 20,
        "thumbnails": [
          "https://lb1.green-acres.com/49661a/Antv5yleb73gh6b9/miniPhotos/Antv5yleb73gh6b9_1.jpg",
          "https://lb1.green-acres.com/49661a/Antv5yleb73gh6b9/miniPhotos/Antv5yleb73gh6b9_2.jpg",
          "https://lb1.green-acres.com/49661a/Antv5yleb73gh6b9/miniPhotos/Antv5yleb73gh6b9_3.jpg"
        ],
        "agency": {
          "name": "Agence TOURRE",
          "logo": "https://lb1.green-acres.com/ClientLogos/222798.png",
          "account_id": "49661a"
        }
      },
      {
        "listing_id": "Aukn6jb77zd8n4zm",
        "url": "https://www.green-acres.fr/fr/properties/immobilier/largentiere/Aukn6jb77zd8n4zm.htm",
        "title": "Une maison de village de 80 m2 datant du 16ème dans le centre médiéval de Largentière.",
        "price": 90000,
        "currency": "EUR",
        "price_on_request": false,
        "price_from": false,
        "price_per_m2": 1125,
        "city": "Largentière",
        "department": "Ardèche",
        "property_type": "Maison de village",
        "is_new_build": false,
        "is_exclusive": true,
        "rooms": 4,
        "bedrooms": 3,
        "living_area_m2": 80,
        "land_area_m2": 35,
        "description_snippet": "LARGENTIERE : dans le centre médiéval, cette maison de village typique datant au moins du 16ème siècle, fut rénovée récemment. Elle offre 80 m2 habitables et un local voûté de 24 m2 au rez-de-chaussée, restant à rénover. Elle comprend au 1e…",
        "photo_count": 9,
        "thumbnails": [
          "https://lb1.green-acres.com/380a/Aukn6jb77zd8n4zm/miniPhotos/Aukn6jb77zd8n4zm_1.jpg",
          "https://lb1.green-acres.com/380a/Aukn6jb77zd8n4zm/miniPhotos/Aukn6jb77zd8n4zm_2.jpg",
          "https://lb1.green-acres.com/380a/Aukn6jb77zd8n4zm/miniPhotos/Aukn6jb77zd8n4zm_3.jpg"
        ],
        "agency": {
          "name": "IRS IMMOBILIER",
          "logo": "https://lb1.green-acres.com/ClientLogos/108086.png",
          "account_id": "380a"
        }
      },
      {
        "listing_id": "Ahj4mz8mdhtckwrj",
        "url": "https://www.green-acres.fr/fr/properties/immobilier/sablieres/Ahj4mz8mdhtckwrj.htm",
        "title": "Maison de village 4 pièces avec combles aménageables",
        "price": 98000,
        "currency": "EUR",
        "price_on_request": false,
        "price_from": false,
        "price_drop_percent": 11,
        "city": "Sablières",
        "department": "Ardèche",
        "property_type": "Maison",
        "is_new_build": false,
        "is_exclusive": true,
        "rooms": 4,
        "bedrooms": 3,
        "living_area_m2": 74,
        "description_snippet": "Située au coeur d'un village typique de l'Ardèche méridionale, cette maison mitoyenne pleine de caractère offre un beau potentiel après rénovation. Élevée sur trois niveaux, elle se compose : Rez-de-chaussée : deux caves, une salle d'eau et…",
        "photo_count": 17,
        "thumbnails": [
          "https://lb1.green-acres.com/4053086a/Ahj4mz8mdhtckwrj/miniPhotos/Ahj4mz8mdhtckwrj_1.jpg?639293301940000000",
          "https://lb1.green-acres.com/4053086a/Ahj4mz8mdhtckwrj/miniPhotos/Ahj4mz8mdhtckwrj_2.jpg?639293301940000000",
          "https://lb1.green-acres.com/4053086a/Ahj4mz8mdhtckwrj/miniPhotos/Ahj4mz8mdhtckwrj_3.jpg?639293301940000000"
        ],
        "agency": {
          "name": "Isabelle Terrier",
          "parent": "Propriétés Privées",
          "account_id": "4053086a"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 24,
      "total": 345,
      "total_pages": 15,
      "max_pages": 20,
      "capped": false,
      "has_next_page": true
    },
    "items_dropped": 0,
    "total_includes_dropped": false,
    "applied_filters": {
      "location": "dp_07",
      "sort": "price_asc",
      "property_type": "house",
      "price_max": "400000",
      "bedrooms_min": "3"
    }
  },
  "meta": {
    "endpoint_family": "search",
    "attempts": 1,
    "items_dropped": 0,
    "request_id": "req_7b436bfffd4540da9a64c2ca22218213",
    "credits_charged": 1,
    "credits_remaining": 1867
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#listing_idstringurlurltitlestringpriceintegercurrencystringprice_on_requestbooleanprice_frombooleanprice_per_m2numbercitystringdepartmentstringproperty_typestringis_new_buildbooleanis_exclusivebooleanroomsintegerbedroomsintegerliving_area_m2integerdescription_snippetstringphoto_countintegerthumbnailsstring[]agencyobject
1Antv5yleb73gh6b9https://www.green-acres.fr/fr/properties/immobilier/saint-alban-auriolles/Antv5yleb73gh6b9.htmAu cœur de Saint-Alban-Auriolles, une âme de pierre vous attend88000EURfalsefalse727Saint-Alban-AuriollesArdècheVillafalsetrue43121EXCLUSIVITE TOURRE IMMOBILIER Telle une gardienne silencieuse du passé, cette maison ardéchoise murmure encore les histoires d’un temps révolu. Dominant le parvis de l’église, elle s’impose avec grâce, noble et discrète, dès que vous en fra…20[3 items]{3 fields}
2Aukn6jb77zd8n4zmhttps://www.green-acres.fr/fr/properties/immobilier/largentiere/Aukn6jb77zd8n4zm.htmUne maison de village de 80 m2 datant du 16ème dans le centre médiéval de Largentière.90000EURfalsefalse1125LargentièreArdècheMaison de villagefalsetrue4380LARGENTIERE : dans le centre médiéval, cette maison de village typique datant au moins du 16ème siècle, fut rénovée récemment. Elle offre 80 m2 habitables et un local voûté de 24 m2 au rez-de-chaussée, restant à rénover. Elle comprend au 1e…9[3 items]{3 fields}
3Ahj4mz8mdhtckwrjhttps://www.green-acres.fr/fr/properties/immobilier/sablieres/Ahj4mz8mdhtckwrj.htmMaison de village 4 pièces avec combles aménageables98000EURfalsefalse—SablièresArdècheMaisonfalsetrue4374Située au coeur d'un village typique de l'Ardèche méridionale, cette maison mitoyenne pleine de caractère offre un beau potentiel après rénovation. Élevée sur trois niveaux, elle se compose : Rez-de-chaussée : deux caves, une salle d'eau et…17[3 items]{3 fields}

Recorded from our API · 3 items shown · 20 datapoints per itemGET /v1/green-acres/search?location=dp_07&property_type=house&sort=price_asc&price_max=400000&bedrooms_min=3

20 datapoints

Identity

  • listing_idstring
  • titlestring
  • property_typestring

Contact

  • urlurl

Location

  • citystring
  • living_area_m2integer

Reputation

  • photo_countinteger

Price

  • priceinteger
  • currencystring
  • price_on_requestboolean
  • price_fromboolean
  • price_per_m2number

Other

  • departmentstring
  • is_new_buildboolean
  • is_exclusiveboolean
  • roomsinteger
  • bedroomsinteger
  • description_snippetstring
  • thumbnailsstring[]
  • agencyobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/green-acres/search?location=dp_07&property_type=house&sort=price_asc&price_max=400000&bedrooms_min=3" \
  -H "X-API-Key: $API_KEY"

Green-Acres · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/green-acres/agency
none+3 optional
1 credit
GET/v1/green-acres/autocomplete
query
1 credit
GET/v1/green-acres/listing
none+3 optional
1 credit
GET/v1/green-acres/search
location+15 optional
1 credit

Overview

What you can get

The Green-Acres API returns Green-Acres property data as JSON through 4 endpoints.

  • Search: search takes a location, with property_type (house, apartment, castle, land, commercial, new_build, building, parking or other), sort (relevance, price_asc, price_desc, surface_asc, surface_desc, price_per_m2_asc, price_per_m2_desc or newest), page, price_min, price_max, living_area_min, living_area_max, land_area_min, land_area_max, rooms_min, rooms_max, bedrooms_min, bedrooms_max, bathrooms_min and bathrooms_max.
  • Listings: listing takes an id or a url, with city_slug.
  • Agencies: agency takes an agency_key and slug, or a url.
  • Locations: autocomplete takes a query.

The recorded search for houses in the Ardèche department (location=dp_07) up to 400,000 EUR with at least 3 bedrooms, cheapest first, returns data.items, each with listing_id, url, title, price, currency, price_on_request, price_per_m2, city, department, property_type, is_new_build, is_exclusive, rooms, bedrooms, living_area_m2, description_snippet, photo_count, thumbnails and agency. It also returns pagination with total (345), total_pages, max_pages, capped and has_next_page, plus applied_filters.

How a call works

Search a department: GET /v1/green-acres/search?location=dp_07&property_type=house&sort=price_asc&price_max=400000&bedrooms_min=3 with your key in the X-API-Key header. Each item's listing_id goes to listing as id. Page with page while has_next_page is true, and check capped and max_pages to know how deep a search goes. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices for country houses in a French department

Use the Green-Acres API to track asking prices for country houses in a French department

Compare `price_per_m2` across towns

Use the Green-Acres API to compare `price_per_m2` across towns

Find properties with land using `land_area_min`

Use the Green-Acres API to find properties with land using `land_area_min`

Watch castles and other rare property types with `property_type=castle`

Use the Green-Acres API to watch castles and other rare property types with `property_type=castle`

FAQ

Questions

Do I need a Green-Acres account?

No. You call this Green-Acres API with your Perceptlayer key in the `X-API-Key` header, with no Green-Acres login.

How much does the Green-Acres API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

How do I find a location code?

`autocomplete` takes a `query`, such as paris. The recorded search uses the department code dp_07 for Ardèche as `location`.

Should I build a Green-Acres scraper instead?

You can, but a Green-Acres scraper is code you maintain: page changes break it, requests get blocked, and Green-Acres's terms govern how you collect data. The Green-Acres API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Green-Acres API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs