Scraperr

# SeLoger API Search and fetch full details from **seloger.com**, France's largest dedicated real-estate portal. Apartments, houses, lots, parking, commercial — buy and rent, all behind two simple GET endpoints. Pass any SeLoger search or detail URL, get back structured JSON with the full classified payload. * Single HTTP call replaces an entire scraping stack. * Both Buy and Rent transactions in one schema, with `transaction` and rental-specific fields surfaced on each card. * All SeLoger URL formats supported. ## Quick start ### cURL ```bash curl 'https://seloger-real-estate.p.rapidapi.com/v1/seloger/search?url=https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=Apartment&locations=AD09FR40' \ -H 'X-RapidAPI-Key: YOUR_KEY' ``` ### Python ```python import requests resp = requests.get( "https://seloger-real-estate.p.rapidapi.com/v1/seloger/search", params={ "url": ( "https://www.seloger.com/classified-search" "?distributionTypes=Buy&estateTypes=Apartment&locations=AD09FR40" ), }, headers={ "X-RapidAPI-Key": "YOUR_KEY", }, timeout=30, ) data = resp.json() print(data["total_results"], "ads matched") for card in data["results"][:5]: print(card["id"], card["title"], card["price_eur"]) ``` ### JavaScript ```javascript const url = 'https://seloger-real-estate.p.rapidapi.com/v1/seloger/search?url=' + encodeURIComponent( 'https://www.seloger.com/classified-search?distributionTypes=Buy' + '&estateTypes=Apartment&locations=AD09FR40' ); const resp = await fetch(url, { headers: { 'X-RapidAPI-Key': 'YOUR_KEY', 'X-RapidAPI-Host': 'seloger-real-estate.p.rapidapi.com', }, }); const data = await resp.json(); console.log(data.total_results, 'ads matched'); ``` ## Endpoints ### `GET /v1/seloger/search` Returns a single page of search results. Query parameter `url`: any SeLoger search URL. Every URL shape SeLoger publishes works: * `https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=Apartment&locations=AD09FR40` * `https://www.seloger.com/annonces/achat/appartement/paris-15eme-75/` * SEO slug paths from external links The query string in your URL passes through to SeLoger, so all native filters work: price range, surface range, rooms, energy class, furnished, build state, project type, sort order, pagination, etc. We don't decompose the URL, so SeLoger filters you didn't know existed will just work. Response shape: ```json { "results": [ /* up to ~32 SeLogerCard objects */ ], "page": 1, "per_page": 32, "total_results": 2164, "next_page_url": "https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=Apartment&locations=AD09FR40&page=2" } ``` `next_page_url` is computed from `total_results` and the current page — when more pages exist, it returns the canonical URL you'd pass back into `/v1/seloger/search` to fetch the next page. `null` when you're on the last page or `total_results` is unknown. ### `GET /v1/seloger/ad` Returns the full detail for a single SeLoger ad. Query parameter `url`: a SeLoger detail URL like `https://www.seloger.com/annonces/achat/appartement/paris-15eme-75/26M75V7LZN7K.htm`. Response: a `SeLogerAdResponse` envelope with the verbatim SeLoger `classified` payload under `data`. See **The Ad object** below for shape details. ## The Card object (SERP) Each entry in `results[]` from `/v1/seloger/search`: ```json { "id": "26M75V7LZN7K", "legacy_id": "265859017", "url": "https://www.seloger.com/annonces/achat/appartement/paris-15eme-75/georges-brassens/265859017.htm", "title": "Appartement à vendre", "transaction": "Buy", "price_text": "550 000 € 12 500 €/m²", "price_eur": 550000, "price_per_m2_eur": 12500, "monthly_rent_eur": null, "surface_m2": 44, "rooms": 2, "bedrooms": 1, "floor_text": "1er étage", "energy_class": "D", "address": "Georges Brassens, Paris 15ème arrondissement (75015)", "agency_name": "Cabinet X" } ``` For rental cards, `transaction` is `"Rent"`, `monthly_rent_eur` carries the monthly rent, and `price_eur` mirrors it (so buy-side callers reading `price_eur` keep working without branching on transaction type). ## The Ad object (detail) `/v1/seloger/ad` returns an envelope plus a pass-through `data` field: ```json { "id": "26M75V7LZN7K", "legacy_id": "265859017", "url": "https://www.seloger.com/annonces/achat/appartement/paris-15eme-75/26M75V7LZN7K.htm", "fetched_at": "2026-05-16T19:43:43Z", "data": { "id": "26M75V7LZN7K", "brand": "seloger", "metadata": { "legacyId": "265859017" }, "sections": { "price": { "base": 550000 }, "characteristics": { "surface": 44, "rooms": 2, "bedrooms": 1 }, "address": { "city": "Paris", "postalCode": "75015" }, "medias": [ /* photos, plans, virtual tours */ ] }, "contactSections": { "agency": { "name": "Cabinet X", "phone": "..." } } } } ``` `data` is the full SeLoger `classified` payload, untyped pass-through. Top-level sections vary by listing (a rental and a buy show different sub-trees), but the structure is stable. ## Pagination Two ways to paginate: 1. **Use the response's `next_page_url`** — pass it back into `/v1/seloger/search` to fetch the next page. Keeps working even if SeLoger changes its URL shape upstream. 2. **Append `&page=N` to your SeLoger URL** — same as on the SeLoger website. The `page` and `total_results` fields in the response tell you the bounds; `per_page` reports how many cards actually came back on this page (SeLoger typically returns 25-33 per page; rentals at the edge of a query range may return fewer). When `(page * per_page) >= total_results`, `next_page_url` is `null`. ## Pricing See the Pricing tab for current quotas and per-overage rates. ## Use cases * Property-market analytics: track new listings, price trends, days-on-market, and price-per-m² by arrondissement or commune. * Buyer's-agent automation: monitor saved searches and alert clients on new matches within seconds of publication. * Investment-portfolio dashboards: pull rental yields across regions by aggregating `/search` results on Rent listings. * Comparative-market analysis: feed appraisal tools with comparable listings filtered by surface, rooms, and energy class. * Lead generation for real-estate professionals: surface FSBO (private) listings vs. agency listings via the `agency_name` field on cards. ## Support Found a bug or have a question about the API? Reach out via the Discussions tab or contact us at the email on the General tab. For pricing or billing questions, RapidAPI's billing team handles those directly through the dashboard. ## Disclaimer This API provides programmatic access to publicly available seloger.com listings. You are responsible for ensuring your use complies with SeLoger's terms of service and any applicable laws (data protection, scraping, redistribution) in your jurisdiction. We do not warrant that listings are accurate, complete, or up-to-date; they reflect what SeLoger shows at the time of your request.