# SeLoger Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/seloger/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/seloger-search |

## Description

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

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/seloger/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search apartments for sale in Bordeaux

```json
[
  {
    "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": []
  }
]
```

## Documentation

## Overview
Extract property listings from any SeLoger search page. Returns structured listing data including pricing, photos, agency contact, and transport information.

## Quickstart
```
GET https://api.piloterr.com/v2/seloger/search?query=https://www.seloger.com/annonces/achat/appartement/bordeaux-33/
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full SeLoger search URL |
| `return_page_source` | boolean | no | Return raw HTML instead of JSON (default: `false`) |

## Main use cases
- Build real estate market dashboards aggregating listings by city and price
- Power automated property alerts matching buyer criteria
- Conduct investment analysis by monitoring price-per-sqm trends
- Enrich lead generation workflows with live SeLoger listings
- Create property comparison engines across multiple cities