GET/v1/results

Get Results

Retrieve scraped PAP.fr property listings with details, energy ratings, and contact information

Retrieve property listings scraped from PAP.fr search results. Each result contains comprehensive property details including price, location coordinates, energy performance ratings (DPE), greenhouse gas emissions (GES), and direct contact information from private sellers.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Result Fields

id
integer
Unique identifier for this result record
Example: 201385
object
string
Object type, always "result"
Example: result
squid
string
Hash ID of the squid that produced this result
Example: c21d10b1466749489fa45424753a5700
run
string
Hash ID of the run during which this result was scraped
Example: 304ec62f79a64597936b9b9e566cb2e9
title
string
Headline or title of the listing
Example: Vente maison 152 m² Oyonnax (01100)
price
number
Listing price in the specified currency
Example: 275000
currency
string
Currency unit for the price field
Example: euro
rooms
integer
Total number of rooms (living spaces)
Example: 6
bedrooms
integer
Number of bedrooms
Example: 4
size
numbernull
Property size or land area in square meters
Example: 152
neighborhood
string
Neighborhood or postal area
Example: Oyonnax (01100)
lat
string
Latitude coordinate of the property
Example: 46.253456
lng
string
Longitude coordinate of the property
Example: 5.648262
description
string
Full textual description of the property
Example: Maison de caractère avec vue panoramique...
energy
stringnull
Energy performance rating (DPE: A-G)
Example: E
ges
stringnull
Greenhouse gas emissions rating (A-G)
Example: B
phone
string
Contact phone number for inquiries
Example: 07 45 71 53 84
image_urls
string
Comma-separated list of listing image URLs
Example: https://cdn.pap.fr/photos/...
url
string
Direct URL to the listing on PAP
Example: https://www.pap.fr/annonces/maison-oyonnax-01100-r457702759
publication_date
string
ISO date when the listing was published
Example: 2025-07-17T00:00:00Z
ref
string
Internal reference code for the listing
Example: F77/2759
internal_id
string
PAP's internal ID for this publication
Example: 457702759
breadcrumb
stringnull
Navigation path or category breadcrumb
Example: null
scraping_time
string
ISO timestamp when the listing was fetched
Example: 2025-07-17T09:34:32.498Z
native_id
integer
Native numeric ID matching the listing
Example: 201385
functions
objectnull
Reserved for function-specific metadata
Example: null

Parameters

squidstring
Required
The squid hash ID to get results from
runstring
Optional
Filter results by specific run hash ID
pageinteger
Optional
Page number for pagination (default: 1)
page_sizeinteger
Optional
Number of results per page (default: 100, max: 1000)
Pro Tip

Pro Tip

Use the energy and ges fields to filter for energy-efficient properties. Ratings A-C are considered good, while D-G indicate higher energy consumption.
Note

Note

Phone numbers are direct contacts to private sellers. French mobile numbers start with 06 or 07.