--- title: "Green-Acres API: JSON data, 4 endpoints, 1 credit per call" description: "Green-Acres API for property search, listings, agencies and location autocomplete as JSON, with houses, castles, land and more. 1 credit per successful call." url: https://perceptlayer.com/apis/green-acres --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Green-Acres 1 credit per call 4 endpoints 20 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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\_id string | url url | title string | price integer | currency string | price\_on\_request boolean | price\_from boolean | price\_per\_m2 number | city string | department string | property\_type string | is\_new\_build boolean | is\_exclusive boolean | rooms integer | bedrooms integer | living\_area\_m2 integer | description\_snippet string | photo\_count integer | thumbnails string\[\] | agency object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | Antv5yleb73gh6b9 | https://www.green-acres.fr/fr/properties/immobilier/saint-alban-auriolles/Antv5yleb73gh6b9.htm | Au cœur de Saint-Alban-Auriolles, une âme de pierre vous attend | 88000 | EUR | false | false | 727 | Saint-Alban-Auriolles | Ardèche | Villa | false | true | 4 | 3 | 121 | 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… | 20 | \[3 items\] | {3 fields} | | 2 | Aukn6jb77zd8n4zm | https://www.green-acres.fr/fr/properties/immobilier/largentiere/Aukn6jb77zd8n4zm.htm | Une maison de village de 80 m2 datant du 16ème dans le centre médiéval de Largentière. | 90000 | EUR | false | false | 1125 | Largentière | Ardèche | Maison de village | false | true | 4 | 3 | 80 | 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… | 9 | \[3 items\] | {3 fields} | | 3 | Ahj4mz8mdhtckwrj | https://www.green-acres.fr/fr/properties/immobilier/sablieres/Ahj4mz8mdhtckwrj.htm | Maison de village 4 pièces avec combles aménageables | 98000 | EUR | false | false | — | Sablières | Ardèche | Maison | false | true | 4 | 3 | 74 | 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… | 17 | \[3 items\] | {3 fields} | Recorded from our API · 3 items shown · 20 datapoints per item GET /v1/green-acres/search?location=dp\_07&property\_type=house&sort=price\_asc&price\_max=400000&bedrooms\_min=3 20 datapoints ### Identity - listing\_id string - title string - property\_type string ### Contact - url url ### Location - city string - living\_area\_m2 integer ### Reputation - photo\_count integer ### Price - price integer - currency string - price\_on\_request boolean - price\_from boolean - price\_per\_m2 number ### Other - department string - is\_new\_build boolean - is\_exclusive boolean - rooms integer - bedrooms integer - description\_snippet string - thumbnails string\[\] - agency object Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/green-acres/agency`](https://perceptlayer.com/apis/green-acres/agency) | none +3 optional | 1 credit | | [GET `/v1/green-acres/autocomplete`](https://perceptlayer.com/apis/green-acres/autocomplete) | `query` | 1 credit | | [GET `/v1/green-acres/listing`](https://perceptlayer.com/apis/green-acres/listing) | none +3 optional | 1 credit | | [GET `/v1/green-acres/search`](https://perceptlayer.com/apis/green-acres/search) | `location` +15 optional | 1 credit | Overview ## About the Green-Acres API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)