Get Results
Retrieve scraped data from ParuVendu Listings Scraper
https://api.lobstr.io/v1/resultsRetrieve scraped data from your ParuVendu Listings Scraper runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
squidstringqueryrequiredHash of the squid to get results from.
runstringqueryHash of a specific run (optional).
pageintegerqueryPage number (default: 1).
page_sizeintegerqueryResults per page (default: 50, max: 100).
Result Fields
urlstringDirect URL to the listing on paruvendu.fr.
titlestringTitle of the listing. Example: BMW Série 3 320d 150ch
sectionstringTop-level category of the listing (e.g. car, real estate). Example: voiture
annonce_typestringType of listing (e.g. sale, rental). Example: vente
asset_typestringSub-category or asset type within the section. Example: berline
priceintegerListed price. Example: 12500
currencystringCurrency of the price. Example: EUR
makestringVehicle manufacturer or brand. Example: BMW
modelstringVehicle model. Example: Série 3
yearintegerYear of manufacture. Example: 2018
mileageintegerOdometer reading in kilometres. Example: 85000
fuel_typestringFuel type (e.g. Diesel, Essence, Électrique). Example: Diesel
gearboxstringGearbox type (e.g. Manuelle, Automatique). Example: Manuelle
locationstringCity or region of the listing. Example: Paris
postal_codestringPostal code of the listing location. Example: 75001
room_countintegerNumber of rooms (for real estate listings).
areaintegerSurface area in square metres (for real estate listings).
picturestringURL of the main listing image.
description_previewstringShort preview of the listing description.
descriptionstringFull description text (available when get_annonce_details is enabled).
featuresstringList of features or equipment (available when get_annonce_details is enabled).
seller_namestringName of the seller (available when get_annonce_details is enabled).
seller_urlstringURL to the seller's profile page (available when get_annonce_details is enabled).
seller_ads_countintegerNumber of active listings by the seller (available when get_annonce_details is enabled).
phonestringSeller phone number (available when get_annonce_details is enabled).
referencestringUnique listing reference number on paruvendu.fr.
last_publication_datestringDate the listing was last published or refreshed. Example: 2026-03-15
updated_atstringISO 8601 timestamp of the last update. Example: 2026-03-15T10:30:00Z
dpe_energystringEnergy performance rating (DPE) for real estate listings (A–G). Example: C
dpe_greenhousestringGreenhouse gas emission rating (GES) for real estate listings (A–G). Example: D
list_infosstringAdditional structured info extracted from the listing summary.
Code Examples
curl -X GET "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=1&page_size=50" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "total_results": 87, "limit": 50, "page": 1, "total_pages": 2, "result_from": 1, "result_to": 50, "data": [ { "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4", "object": "result", "squid": "YOUR_SQUID_HASH", "run": "RUN_HASH", "url": "https://www.paruvendu.fr/a/voiture-occasion/bmw/serie-3/12345678/", "title": "BMW Série 3 320d 150ch BVA", "section": "voiture", "annonce_type": "vente", "asset_type": "berline", "price": 12500, "currency": "EUR", "make": "BMW", "model": "Série 3", "year": 2018, "mileage": 85000, "fuel_type": "Diesel", "gearbox": "Automatique", "location": "Paris", "postal_code": "75001", "picture": "https://img.paruvendu.fr/thumb/12345678_1.jpg", "description_preview": "Véhicule en excellent état, révision faite...", "last_publication_date": "2026-03-15", "reference": "12345678", "scraping_time": "2026-03-20T09:15:00.000Z" } ], "next": "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=2&page_size=50", "previous": null }