GET/v1/results

Get Results

Retrieve scraped Leboncoin listings with details and seller information

Retrieve scraped classified listings from Leboncoin including pricing, location, seller details, and property-specific fields like DPE/GES ratings.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Listing Information

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: Chaise de bureau

description

string

Full listing description

Example: Je vends chaise de bureau...

price

integer

Listing price

Example: 20

currency

string

Currency code

Example: EUR

url

string

Direct URL to the listing

Example: https://www.leboncoin.fr/ad/...

annonce_id

string

Leboncoin listing ID

Example: 3017342920

category_name

string

Category of the listing

Example: Ameublement

ad_type

string

Type of ad (offer/search)

Example: offer

Location Information

city

string

City name

Example: Aix-en-Provence

city_label

string

City with postal code

Example: Aix-en-Provence 13100

postal_code

string

Postal code

Example: 13100

department

string

French department

Example: Bouches-du-Rhône

region

string

Region name

Example: Provence-Alpes-Côte d'Azur

lat

string

Latitude coordinate

Example: 43.52638

lng

string

Longitude coordinate

Example: 5.44614

Seller Information

owner_name

string

Seller's display name

Example: EMMA

owner_type

string

Seller type code

Example: 0

owner_store_id

string

Seller's store ID

Example: 1095173

owner_siren

stringnull

Business SIREN number

Example: null

has_phone

boolean

Whether phone is available

Example: false

has_online_shop

boolean

Whether seller has shop URL

Example: false

online_shop_url

stringnull

Seller's shop URL

Example: null

Real Estate Fields

DPE

stringnull

Energy Performance rating (A-G)

Example: C

DPE_int

integernull

Numeric DPE value

Example: 3

GES

stringnull

Greenhouse Gas rating (A-G)

Example: B

GES_int

integernull

Numeric GES value

Example: 2

area

stringnull

Property area (sqm)

Example: 75

room_count

integernull

Number of rooms

Example: 3

real_estate_type

stringnull

Property type

Example: apartment

furnished

booleannull

Whether furnished

Example: false

price_per_square_meter

numbernull

Price per sqm

Example: 4500.5

Media & Status

picture

string

Primary image URL

Example: https://img.leboncoin.fr/...

pictures

string

Comma-separated image URLs

Example: url1, url2, url3

first_publication_date

string

When first published (ISO)

Example: 2025-07-04T04:05:30Z

last_publication_date

string

When last updated (ISO)

Example: 2025-07-04T04:05:30Z

urgent

boolean

Marked as urgent

Example: false

booster

boolean

Listing is boosted

Example: false

scraping_time

string

When scraped (ISO)

Example: 2025-07-04T04:08:09.340Z

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

The `details` object contains structured attributes that vary by category (furniture type, condition, color, etc.).

Pro Tip

Use `first_publication_date` to filter for new listings when processing results.

Note

DPE/GES fields are only populated for real estate listings.