Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "url": "<string>",
  "title": "<string>",
  "section": "<string>",
  "annonce_type": "<string>",
  "asset_type": "<string>",
  "price": 123,
  "currency": "<string>",
  "make": "<string>",
  "model": "<string>",
  "year": 123,
  "mileage": 123,
  "fuel_type": "<string>",
  "gearbox": "<string>",
  "location": "<string>",
  "postal_code": "<string>",
  "room_count": 123,
  "area": 123,
  "picture": "<string>",
  "description_preview": "<string>",
  "description": "<string>",
  "features": "<string>",
  "seller_name": "<string>",
  "seller_url": "<string>",
  "seller_ads_count": 123,
  "phone": "<string>",
  "reference": "<string>",
  "last_publication_date": "<string>",
  "updated_at": "<string>",
  "dpe_energy": "<string>",
  "dpe_greenhouse": "<string>",
  "list_infos": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve scraped data from your ParuVendu Listings Scraper runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
squid
string
required
Hash of the squid to get results from.
​
run
string
Hash of a specific run (optional).
​
page
integer
Page number (default: 1).
​
limit
integer
Results per page (default: 50, max: 100).

​
Result Fields

​
url
string
Direct URL to the listing on paruvendu.fr.
​
title
string
Title of the listing. Example: BMW Série 3 320d 150ch
​
section
string
Top-level category of the listing (e.g. car, real estate). Example: voiture
​
annonce_type
string
Type of listing (e.g. sale, rental). Example: vente
​
asset_type
string
Sub-category or asset type within the section. Example: berline
​
price
integer
Listed price. Example: 12500
​
currency
string
Currency of the price. Example: EUR
​
make
string
Vehicle manufacturer or brand. Example: BMW
​
model
string
Vehicle model. Example: Série 3
​
year
integer
Year of manufacture. Example: 2018
​
mileage
integer
Odometer reading in kilometres. Example: 85000
​
fuel_type
string
Fuel type (e.g. Diesel, Essence, Électrique). Example: Diesel
​
gearbox
string
Gearbox type (e.g. Manuelle, Automatique). Example: Manuelle
​
location
string
City or region of the listing. Example: Paris
​
postal_code
string
Postal code of the listing location. Example: 75001
​
room_count
integer
Number of rooms (for real estate listings).
​
area
integer
Surface area in square metres (for real estate listings).
​
picture
string
URL of the main listing image.
​
description_preview
string
Short preview of the listing description.
​
description
string
Full description text (available when get_annonce_details is enabled).
​
features
string
List of features or equipment (available when get_annonce_details is enabled).
​
seller_name
string
Name of the seller (available when get_annonce_details is enabled).
​
seller_url
string
URL to the seller’s profile page (available when get_annonce_details is enabled).
​
seller_ads_count
integer
Number of active listings by the seller (available when get_annonce_details is enabled).
​
phone
string
Seller phone number (available when get_annonce_details is enabled).
​
reference
string
Unique listing reference number on paruvendu.fr.
​
last_publication_date
string
Date the listing was last published or refreshed. Example: 2026-03-15
​
updated_at
string
ISO 8601 timestamp of the last update. Example: 2026-03-15T10:30:00Z
​
dpe_energy
string
Energy performance rating (DPE) for real estate listings (A–G). Example: C
​
dpe_greenhouse
string
Greenhouse gas emission rating (GES) for real estate listings (A–G). Example: D
​
list_infos
string
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&limit=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&limit=50",
  "previous": null
}