Piloterr

SeLoger Search

GET
/v2/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

Autorização

ApiKeyAuth
x-api-key<token>

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

In: header

Parâmetros de consulta

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"

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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"}