Skip to main content
POST
/
api
/
seloger
/
listings
/
search
/seloger/listings/search
curl --request POST \
  --url https://api.anysite.io/api/seloger/listings/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "location": "<string>",
  "count": 2,
  "timeout": 300,
  "mode": "achat",
  "property_type": "all",
  "sort": "relevance",
  "min_price": 1,
  "max_price": 1,
  "min_area": 1,
  "max_area": 1,
  "min_rooms": 2
}
'
[
  {
    "id": "<string>",
    "@type": "@seloger_search_listing",
    "url": "<string>",
    "title": "<string>",
    "property_type": "<string>",
    "is_new": true,
    "is_exclusive": true,
    "price": 123,
    "price_per_m2": 123,
    "monthly_price": 123,
    "area_m2": 123,
    "room_count": 123,
    "bedroom_count": 123,
    "energy_class": "<string>",
    "description": "<string>",
    "tags": [],
    "city": "<string>",
    "zip_code": "<string>",
    "district": "<string>",
    "images": [],
    "agency": {
      "@type": "@seloger_search_agency",
      "id": "<string>",
      "name": "<string>",
      "is_private_seller": true,
      "phone": "<string>",
      "image": "<string>"
    }
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
location
string
required

City, arrondissement, neighbourhood or postal code to search in

Minimum string length: 1
Examples:

"Paris 15"

"Bordeaux"

"Lyon"

"75015"

count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
mode
enum<string>
default:achat

Listing mode

Available options:
achat,
location
property_type
enum<string>
default:all

Property type filter

Available options:
all,
appartement,
maison
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
price_asc,
price_desc,
date_desc
min_price
integer | null

Minimum price filter

Required range: x >= 0
max_price
integer | null

Maximum price filter

Required range: x >= 0
min_area
integer | null

Minimum living area filter in m²

Required range: x >= 0
max_area
integer | null

Maximum living area filter in m²

Required range: x >= 0
min_rooms
integer | null

Minimum number of rooms filter

Required range: x >= 1

Response

Successful Response

id
string
required
@type
string
default:@seloger_search_listing
url
string | null
title
string | null
property_type
string | null
is_new
boolean | null
is_exclusive
boolean | null
price
integer | null
price_per_m2
number | null
monthly_price
integer | null
area_m2
number | null
room_count
integer | null
bedroom_count
integer | null
energy_class
string | null
description
string | null
tags
string[]
city
string | null
zip_code
string | null
district
string | null
images
string[]
agency
SelogerSearchAgency · object