ParuVendu Scraper API
Extract structured property data from public ParuVendu pages as JSON. Send a listing URL and receive the fields exposed by the target page.
Decide before you build
- Endpoint
- POST /scrape/real-estate
- Scrapers
- ParuVendu property listing pages
- Cost
- from 1 credit / call
- Free plan
- 1,000 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 ParuVendu scraper on your own targetRun a request against a public property listing page and inspect the JSON before you integrate.
Open the live testWhat you get back
property dataParuVendu data in JSON
Retrieve the property information exposed by the public ParuVendu 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 optionsControl 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 ParuVendu scraper
Send a public listing URL to the Real Estate endpoint. The API returns the result in the same response.
# 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://example.com/listing/123",
"options": {
"useChrome": false,
"premiumProxy": false
}
}'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://example.com/listing/123", options: { useChrome: false, premiumProxy: false } }),
});
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 keyRequest 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
Example returned by the legacy ParuVendu scraper documentation.
{
"data": {
"title": "Annonce quartier st-exupery grand t1bis, avec balcon cave parking, vente 1 pièce de particulier Haute-Garonne - ParuVendu.fr ref WI173665716",
"description": "Découvrez cette annonce d'appartement à vendre de 29m2 au prix de 126 000� à Toulouse (Haute-Garonne) proposée par un particulier sur 173665716",
"parcelSurfaceArea": null,
"surfaceArea": null,
"surfaceAreaUnit": null,
"price": 126000,
"currency": "EUR",
"numberOfRooms": null,
"numberOfBedrooms": null,
"publishingDate": null,
"monthlyRent": null,
"weeklyRent": null,
"marketedBy": {},
"energyClass": null,
"greenhouseGazClass": null,
"buildYear": null,
"postalCode": null,
"city": null,
"image": [
"https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/77/f5/L21lZGlhLXBhL1dJMTcvMy82L1dJMTczNjY1NzE2XzEuanBlZz8yMDI0MDUxNDIxMDIxMg_rct?func=crop&w=1000&gravity=auto"
],
"insulation": null,
"siteURL": "https://www.paruvendu.fr/immobilier/vente/appartement/1275559547A1KIVHAP000",
"siteHtml": null,
"statusCode": 200,
"htmlLength": 163415,
"captchaFound": false,
"isHtmlPage": true,
"host": "www.paruvendu.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 ParuVendu API
- Does the ParuVendu scraper access private data?
- No. This guide covers public property listing pages and does not require signing in to a ParuVendu account.
- Are all fields always available?
- No. Returned data depends on what the public ParuVendu 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
Browse the Real Estate category for the complete list of guides, or visit the ScrapingBot blog for implementation guides.
Trusted by developers using Real Estate data.
Customer reviews apply to ScrapingBot's service overall, not specifically to this scraper.
Start scraping ParuVendu today
1,000 free credits every month. No card required, cancel anytime.
