GET/v1/results

Get Results

Retrieve scraped SeLoger real estate listings

Retrieve scraped SeLoger real estate listings including property details, pricing, location, agency information, and energy performance ratings.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Core Result Fields

integer

Unique result identifier

Example: 7779945

object

string

Always "result"

Example: result

squid

string

Squid that produced this result

Example: e23069fee2594ee0aed755be195b156c

run

string

Run that produced this result

Example: 6ecdfb8a43c841d18502f045200196f7

annonce_id

integer

Unique SeLoger listing identifier

Example: 246281705

Property Information

title

string

Headline/title of the listing

Example: Appartement 3 pièces 75m²

description

string

Full listing description

Example: Bel appartement lumineux...

short_description

string

Brief excerpt of the listing

Example: Appartement à vendre...

url

string

Direct link to the listing

Example: https://www.seloger.com/annonces/achat/...

estate_type

string

Type of property

Example: Appartement

estate_type_id

integer

Numeric code for estate type

Example: 2

area

number

Surface area in square meters

Example: 75.5

rooms

integernull

Number of rooms

Example: 3

bedrooms_count

integernull

Number of bedrooms

Example: 2

is_furnished

boolean

Whether furnished

Example: false

features

stringnull

Key features/amenities

Example: Balcon, Parking

Pricing Information

price

number

Total listing price in euros

Example: 350000

monthly_price

number

Monthly rent/price in euros

Example: 1200

price_per_meter

numbernull

Price per square meter

Example: 4666

transaction_type

integer

Transaction type code (1=rent, 2=sale)

Example: 2

nature

integer

Transaction nature code

Example: 1

Location Information

address

string

Town or locality name

Example: Paris 15ème

postal_code

string

Postal code

Example: 75015

district

stringnull

District or arrondissement

Example: 15ème

insee_code

stringnull

INSEE code for French municipalities

Example: 75115

latitude

number

Geographic latitude

Example: 48.8456

longitude

number

Geographic longitude

Example: 2.2892

Agency Information

agency_contact_name

string

Name of the agency contact

Example: Agence Immobilière Paris

agency_id

integer

Internal SeLoger agency ID

Example: 519049

agency_phone_number

string

Agency contact phone

Example: 01 23 45 67 89

agency_has_email

boolean

Whether agency email is available

Example: true

agency_page

string

URL of agency's SeLoger page

Example: https://www.seloger.com/professionnels/...

agency_img_url

stringnull

Agency logo URL

Example: https://...

agency_link

stringnull

External agency website

Example: https://www.agence.fr

contact_is_private_seller

boolean

True if private seller (not agency)

Example: false

contact_email

boolean

Whether contact email is provided

Example: true

Energy Performance

dpe

stringnull

Energy Performance Diagnostic rating (A-G)

Example: C

ges

stringnull

Greenhouse Gas rating (A-G)

Example: D

electricity_consumption

stringnull

Electricity consumption metric

Example: 150 kWh/m²/an

gas_emissions

stringnull

Greenhouse gas emissions rating

Example: 25 kg CO2/m²/an

Co-ownership Details

coownership_annual_charges

numbernull

Annual co-ownership charges

Example: 2400

coownership_number_of_lots

integernull

Total lots in co-ownership

Example: 50

coownership_is_syndic_procedure

boolean

Under syndic procedure

Example: false

Media & Images

main_picture

string

URL of main listing image

Example: https://mms.seloger.com/...

pictures

string

Comma-separated thumbnail URLs

Example: url1, url2, url3

additional_pictures

string

Comma-separated full-size image URLs

Example: url1, url2, url3

picture_count

integer

Total number of pictures

Example: 8

video_url

stringnull

Video tour URL

Example: https://...

virtual_visit_url

stringnull

3D virtual visit URL

Example: https://...

Listing Status

is_exclusive

boolean

Exclusive listing

Example: false

is_expired

boolean

Listing has expired

Example: false

highlighting_level

integer

Prominence level (higher = more featured)

Example: 3

Timestamps

scraping_time

string

When scraped (ISO 8601)

Example: 2025-07-16T10:04:14.545Z

last_scraping_time

stringnull

Previous scraping time

Example: null

functions.annonce_details.filling_date

string

When detail enrichment ran

Example: 07/16/2025, 08:40:50 +0200

Parameters

squidstring

Required

Hash of the squid to get results from

Example: e23069fee2594ee0aed755be195b156c

runstring

Optional

Hash of a specific run (optional)

Example: 6ecdfb8a43c841d18502f045200196f7

pageinteger

Optional

Page number (default: 1)

Example: 1

page_sizeinteger

Optional

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

Example: 50

Pro Tip

Use `latitude` and `longitude` fields (available when `annonce_details` is enabled) to plot properties on a map.

Pro Tip

Filter by `transaction_type`: 1 for rentals, 2 for sales.

Note

DPE/GES ratings follow French energy diagnostic standards (A = most efficient, G = least efficient).