SeLoger Search

Efficiently extract real estate listings from SeLoger search pages for market insights, property management, and investment analysis.

Credit cost: 2 credits per call

Authorization

ApiKeyAuth

x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

A valid SeLoger search results URL. Any SeLoger search page URL with filters is supported — location, property type, price range, surface, and number of rooms can all be embedded in the URL.

Supported transaction types:

/annonces/achat/ — property for sale
/annonces/locations/ — property for rent

Example:

https://www.seloger.com/annonces/achat/appartement/bordeaux-33/

Notes:

Pagination parameters can be appended directly to the URL
All filters visible in the SeLoger search interface are supported

return_page_source?boolean

Whether to return the raw HTML source of the search results page instead of parsed JSON data.

false: Returns structured JSON array of listings (default)
true: Returns the raw HTML source of the page

Default: false

Note: Useful for debugging or custom parsing workflows.

Default"false"

Response Body

`application/json`

curl -X GET "https://api.piloterr.com/v2/seloger/search?query=string"

[
  {
    "id": 227349507,
    "epc": null,
    "tags": [
      "4 pièces",
      "3 chambres",
      "98 m²",
      "Étage 2/–",
      "Parking",
      "Ascenseur"
    ],
    "rooms": 4,
    "title": "Appartement neuf",
    "is_new": false,
    "nature": 2,
    "photos": [
      "/0/k/z/2/0kz2n5mhqtt4d922z0yk7ey61booyo9gqe5ikflog.jpg",
      "/1/f/4/v/1f4v1cu618rao9z3jydwi7re88naslrnrie78v3i8.jpg"
    ],
    "contact": {
      "email": "true",
      "id_rcu": "RC-082608",
      "img_url": "https://v.seloger.com/s/width/150/logos/0/x/q/v/0xqv4maey1fc6dtb7les934ocr8k2ue8850ffaueo.jpg",
      "agency_id": 76929,
      "agency_link": null,
      "agency_page": null,
      "contact_name": "GROUPE SOVI",
      "phone_number": "05 57 54 11 54",
      "is_private_seller": false
    },
    "pricing": {
      "price": "716 000 €",
      "lifetime": false,
      "raw_price": "716000",
      "price_note": null,
      "monthly_price": 3596,
      "square_meter_price": "7 282 €"
    },
    "surface": 98.32,
    "position": 0,
    "zip_code": "33200",
    "card_type": "classified",
    "transport": null,
    "city_label": "Bordeaux",
    "desk_count": 0,
    "photos_qty": 6,
    "description": "",
    "estate_type": "Appartement neuf",
    "video_u_r_l": null,
    "early_access": null,
    "is_exclusive": false,
    "bedroom_count": 3,
    "business_unit": 2,
    "housing_batch": [
      {
        "label": "3 pièces"
      },
      {
        "label": "2 pièces"
      },
      {
        "label": "5 pièces"
      },
      {
        "label": "4 pièces"
      }
    ],
    "lease_type_id": 0,
    "district_label": "Caudéran-Barrière Judaïque",
    "estate_type_id": 1,
    "publication_id": 30076929,
    "classified_u_r_l": "https://www.selogerneuf.com/annonces/neuf/programme/bordeaux-33/208938143/",
    "optional_criteria": [],
    "partner_link_type": 1,
    "highlighting_level": 3,
    "forced_intermediary": false,
    "transaction_type_id": 2,
    "virtual_visit_u_r_l": "https://vimeo.com/953477395/35ed79aa17?share=copy",
    "missing_optional_criteria": []
  },
  {
    "id": 232159607,
    "epc": "C",
    "tags": [
      "3 pièces",
      "2 chambres",
      "70 m²",
      "Étage 1/2"
    ],
    "rooms": 3,
    "title": "Appartement",
    "is_new": false,
    "nature": 1,
    "photos": [
      "/0/3/f/l/03flt9ozsl0o40fysnzj5d8m9lko4ozrtprgxgyw0.jpg",
      "/0/0/3/q/003qpl4f372irog1qjnwkibqaix3ul4s4uoll7j4w.jpg"
    ],
    "contact": {
      "email": "true",
      "id_rcu": "RC-035271",
      "img_url": "https://v.seloger.com/s/width/150/logos/1/i/8/7/1i870528o8j063099u4r7sk9gqvgr35b1ur2ejaez.jpg",
      "agency_id": 3088,
      "agency_link": null,
      "agency_page": "/professionnels/agences-immobilieres/bordeaux-33000/agence-48208/",
      "contact_name": "GRANGE DELMAS IMMOBILIER",
      "phone_number": "05 56 24 33 00",
      "is_private_seller": false
    },
    "pricing": {
      "price": "472 000 €",
      "lifetime": false,
      "raw_price": "472000",
      "price_note": null,
      "monthly_price": 2525,
      "square_meter_price": "6 743 €"
    },
    "surface": 70,
    "position": 1,
    "zip_code": "33000",
    "card_type": "classified",
    "transport": null,
    "city_label": "Bordeaux",
    "desk_count": 0,
    "photos_qty": 7,
    "description": "Appartement à vendre - BORDEAUX - QUAIS DES CHARTRONS...",
    "estate_type": "Appartement",
    "video_u_r_l": null,
    "early_access": null,
    "is_exclusive": false,
    "bedroom_count": 2,
    "business_unit": 1,
    "housing_batch": [],
    "lease_type_id": 0,
    "district_label": "Grand Parc-Chartrons-Paul Doumer",
    "estate_type_id": 1,
    "publication_id": 30003088,
    "classified_u_r_l": "/annonces/achat/appartement/bordeaux-33/grand-parc-chartrons-paul-doumer/232159607.htm",
    "optional_criteria": [],
    "partner_link_type": 1,
    "highlighting_level": 3,
    "forced_intermediary": false,
    "transaction_type_id": 2,
    "virtual_visit_u_r_l": "https://youtu.be/ncAlgVjfZ0Y",
    "missing_optional_criteria": []
  }
]

{
  "error": "Bad Request"
}

{
  "error": "Invalid API Key"
}

{
  "error": "Payment required"
}

{
  "error": "Rate limit exceeded for the API key: quota monthly"
}

{
  "error": "Internal Error"
}

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`