GET/v1/results

Get Results

Retrieve scraped Leboncoin listings with phone numbers

Retrieve scraped Leboncoin classified listings with extracted phone numbers. Results include all fields from the standard Leboncoin scraper plus phone data.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Phone-Specific Fields

phone
stringnull
Extracted phone number
Example: +33486259896
has_phone
boolean
Whether a phone number was available
Example: true
functions.phone.filling_date
string
When the phone was extracted
Example: 07/04/2025, 06:08:09 +0200

Listing Information

id
integer
Unique result identifier
Example: 53557759
object
string
Always "result"
Example: result
squid
string
Squid that produced this result
Example: 72d18e4c94534b829877bb7c092b1f80
run
string
Run that produced this result
Example: 3ff48bb8ef19426e87fbb3e102dd4531
title
string
Listing title/headline
Example: Appartement 3 pièces
description
string
Full listing description
Example: Bel appartement...
price
integer
Listing price
Example: 150000
url
string
Direct URL to the listing
Example: https://www.leboncoin.fr/ad/...
annonce_id
string
Leboncoin listing ID
Example: 3017342920

Location Information

city
string
City name
Example: Marseille
postal_code
string
Postal code
Example: 13000
department
string
French department
Example: Bouches-du-Rhône
region
string
Region name
Example: Provence-Alpes-Côte d'Azur

Seller Information

owner_name
string
Seller's display name
Example: Jean Dupont
owner_siren
stringnull
Business SIREN number
Example: 123456789
owner_store_id
string
Seller's store ID
Example: 1095173

Real Estate Fields

area
stringnull
Property area (sqm)
Example: 75
room_count
integernull
Number of rooms
Example: 3
DPE
stringnull
Energy Performance rating (A-G)
Example: C
GES
stringnull
Greenhouse Gas rating (A-G)
Example: B
furnished
booleannull
Whether furnished
Example: false

Parameters

squidstring
Required
Hash of the squid to get results from
Example: 72d18e4c94534b829877bb7c092b1f80
runstring
Optional
Hash of a specific run (optional)
Example: 3ff48bb8ef19426e87fbb3e102dd4531
pageinteger
Optional
Page number (default: 1)
Example: 1
page_sizeinteger
Optional
Results per page (default: 50, max: 100)
Example: 50
Pro Tip

Pro Tip

The `phone` field is only populated when `functions.phone` is enabled and the seller has phone contact enabled.
Pro Tip

Pro Tip

Check `has_phone` before accessing the `phone` field to avoid null values.
Note

Note

All other fields are identical to the Leboncoin Listings Search Export scraper.