Immo-Diffusion Scraper API

Extract structured property data from public Immo-Diffusion pages as JSON. Send a listing URL and receive the fields exposed by the target page.

Get your API key Read the documentation500 free credits per month, no card required.

Decide before you build

Endpoint: POST /scrape/real-estate
Scrapers: Immo-Diffusion property listing pages
Cost: from 1 credit / call
Free plan: 500 credits / month
Call pattern: sync, POST
On failure: credits refunded
Response format: JSON
Concurrency: by plan tier

Real Estate requests are synchronous. Cost depends on the options selected for the request.

Try the Immo-Diffusion scraper on your own targetRun a request against a public property listing page and inspect the JSON before you integrate.

Open the live test

What you get back

property data

Immo-Diffusion data in JSON

Retrieve the property information exposed by the public Immo-Diffusion page.

Listing title, description and images
Price, currency and property type when available
Location, surface area and room details
Agency and listing publication data when available

Request options

Control how the page is collected

Use rendering or proxy options only when the target requires them.

JavaScript rendering with useChrome
Premium proxy and country targeting
Public URL input; no account login required
Structured JSON in the same response

Call the Immo-Diffusion scraper

Send a public listing URL to the Real Estate endpoint. The API returns the result in the same response.

Step 1Submit the Immo-Diffusion listing URL and only the options required by the target.

bash

# POST - scrape a public property listing page
curl -X POST "https://api.scraping-bot.io/scrape/real-estate" \
  -u "yourUsername:yourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.immo-diffusion.fr/fr/rhone-alpes/savoie/73000/immobilier-montagnole/vente/177741-maison.html",
  "options": {
    "useChrome": false,
    "premiumProxy": true
  }
}'

Code example

Authenticate with your ScrapingBot username and API key, then read the returned JSON.

const auth = "Basic " + Buffer.from("yourUsername:yourApiKey").toString("base64");

const response = await fetch("https://api.scraping-bot.io/scrape/real-estate", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: auth },
  body: JSON.stringify({ url: "https://www.immo-diffusion.fr/fr/rhone-alpes/savoie/73000/immobilier-montagnole/vente/177741-maison.html", options: { useChrome: false, premiumProxy: true } }),
});

const result = await response.json();

Run this call in two minutesCreate an account, copy your API key, then use the example above.

Get your API key

Request parameters

Parameter	Type	Default	Description
`url`	string	—	Full public page URL, including https://.
`options.useChrome`	boolean	false	Render JavaScript when the target page requires a browser.
`options.premiumProxy`	boolean	false	Use a premium proxy for targets that require it.
`options.proxyCountry`	string	—	Country targeting with a premium proxy.

Response example

Response returned for the public Immo-Diffusion property listing page used in the request example, with long lists shortened. Available fields vary with the target page.

json

{
  "data": {
    "title": "N°Gq183960 - vente Maison Montagnole 73",
    "description": "Gq183960 - Vente Maison / Villa 5 Pieces Montagnole : Vous avez la possibilité de concrétiser votre projet de vie ! Dans ce cadre privilégié - cette maison vous offre à la fois élégance et fonctionnalité - parfaite pour une vie de famille. Votre maison conforme aux normes - offrant une surface ha…",
    "parcelSurfaceArea": null,
    "surfaceArea": 90,
    "surfaceAreaUnit": "sqm",
    "price": 319900,
    "currency": "EUR",
    "numberOfRooms": 5,
    "numberOfBedrooms": 4,
    "publishingDate": null,
    "monthlyRent": null,
    "weeklyRent": null,
    "marketedBy": {
      "name": "LOGI-C filiale du Groupe ESR PROM-S",
      "address": "19 b rue de la républiqueBureaux du GROUPE ESR PROM-S, 69740 GENAS"
    },
    "energyClass": null,
    "greenhouseGazClass": null,
    "buildYear": null,
    "postalCode": null,
    "city": null,
    "image": [
      "https://www.immo-diffusion.fr/media/cache/rect720_455/542/vente/183960/Gq183960a.jpg"
    ],
    "insulation": null,
    "siteURL": "https://www.immo-diffusion.fr/fr/rhone-alpes/savoie/73000/immobilier-montagnole/vente/177741-maison.html",
    "siteHtml": null,
    "statusCode": 200,
    "htmlLength": 212435,
    "captchaFound": true,
    "isHtmlPage": true,
    "host": "www.immo-diffusion.fr"
  }
}

Credits, failures and limits

Case	Credits	Notes
Standard request	from 1 credit / call	Current plans start at this rate.
JavaScript rendering	Additional credits	Enable only when the target requires it.
Premium proxy	Additional credits	Use for targets that require a premium proxy.
Unsuccessful request	Not deducted	Only successful requests count towards the monthly limit.

Real Estate API or Raw HTML scraper?

	Real Estate API	Raw HTML scraper
Endpoint	/scrape/real-estate	/scrape/raw-html
Returns	Structured property JSON	Rendered page HTML
Flow	One synchronous request	One synchronous request
Starting cost	from 1 credit / call	from 1 credit / call
Use it when	You need parsed property fields	You need your own extraction logic

Questions about the Immo-Diffusion API

Does the Immo-Diffusion scraper access private data?: No. This guide covers public property listing pages and does not require signing in to a Immo-Diffusion account.
Are all fields always available?: No. Returned data depends on what the public Immo-Diffusion page exposes and what the extractor supports.
Can I collect multiple pages at once?: Each request takes one public URL. Submit one request per page you need to collect.
When should I use a premium proxy?: Use it only when a target requires it or when you need country targeting for a public page.

Source: ScrapingBot API documentation.

Other real estate scrapers

Real estate Scraper API Funda Scraper API Pap Scraper API PropertyPassBook Scraper API Zillow Scraper API ParuVendu Scraper API

Browse the Real Estate category for the complete list of guides. Visit the ScrapingBot blog for implementation guides.

4.9

★★★★★

133 Google reviews

Trusted by developers using Real Estate data.
Customer reviews apply to ScrapingBot's service overall, not specifically to this scraper.

Start scraping Immo-Diffusion today

500 free credits every month. No card required, cancel anytime.

Get your API key Talk to us