APIs / Green-Acres / Search

Green-Acres: Search

Search from Green-Acres as JSON. 1 credit per successful call.

GET /v1/green-acres/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
locationstringRequiredAny
property_typestringOptionalhouse, apartment, castle, land, commercial, new_build, building, parking, other
sortstringOptionalrelevance, price_asc, price_desc, surface_asc, surface_desc, price_per_m2_asc, price_per_m2_desc, newest
pageintegerOptionalAny
price_minintegerOptionalAny
price_maxintegerOptionalAny
living_area_minintegerOptionalAny
living_area_maxintegerOptionalAny
land_area_minintegerOptionalAny
land_area_maxintegerOptionalAny
rooms_minintegerOptionalAny
rooms_maxintegerOptionalAny
bedrooms_minintegerOptionalAny
bedrooms_maxintegerOptionalAny
bathrooms_minintegerOptionalAny
bathrooms_maxintegerOptionalAny

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.