Skip to content
Examples

Get Results

Retrieve scraped data from ParuVendu Listings Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your ParuVendu Listings Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

runstringquery

Hash of a specific run (optional).

pageintegerquery

Page number (default: 1).

page_sizeintegerquery

Results per page (default: 50, max: 100).

Result Fields

urlstring

Direct URL to the listing on paruvendu.fr.

titlestring

Title of the listing. Example: BMW Série 3 320d 150ch

sectionstring

Top-level category of the listing (e.g. car, real estate). Example: voiture

annonce_typestring

Type of listing (e.g. sale, rental). Example: vente

asset_typestring

Sub-category or asset type within the section. Example: berline

priceinteger

Listed price. Example: 12500

currencystring

Currency of the price. Example: EUR

makestring

Vehicle manufacturer or brand. Example: BMW

modelstring

Vehicle model. Example: Série 3

yearinteger

Year of manufacture. Example: 2018

mileageinteger

Odometer reading in kilometres. Example: 85000

fuel_typestring

Fuel type (e.g. Diesel, Essence, Électrique). Example: Diesel

gearboxstring

Gearbox type (e.g. Manuelle, Automatique). Example: Manuelle

locationstring

City or region of the listing. Example: Paris

postal_codestring

Postal code of the listing location. Example: 75001

room_countinteger

Number of rooms (for real estate listings).

areainteger

Surface area in square metres (for real estate listings).

picturestring

URL of the main listing image.

description_previewstring

Short preview of the listing description.

descriptionstring

Full description text (available when get_annonce_details is enabled).

featuresstring

List of features or equipment (available when get_annonce_details is enabled).

seller_namestring

Name of the seller (available when get_annonce_details is enabled).

seller_urlstring

URL to the seller's profile page (available when get_annonce_details is enabled).

seller_ads_countinteger

Number of active listings by the seller (available when get_annonce_details is enabled).

phonestring

Seller phone number (available when get_annonce_details is enabled).

referencestring

Unique listing reference number on paruvendu.fr.

last_publication_datestring

Date the listing was last published or refreshed. Example: 2026-03-15

updated_atstring

ISO 8601 timestamp of the last update. Example: 2026-03-15T10:30:00Z

dpe_energystring

Energy performance rating (DPE) for real estate listings (A–G). Example: C

dpe_greenhousestring

Greenhouse gas emission rating (GES) for real estate listings (A–G). Example: D

list_infosstring

Additional 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

200
{
  "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
}