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

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Result Fields

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

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

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