Skip to content
Examples

Get Results

Retrieve scraped data from PAP Search Export

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your PAP Search Export runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

internal_idstring

Unique identifier for the listing on PAP (Particulier à Particulier). Example: 460201580

urlstring

Direct URL to the listing on PAP. Example: https://www.pap.fr/annonces/maison-bourg-en-bresse-01000-r460201580

titlestring

Title of the property listing on PAP. Example: Vente maison 122 m² Bourg-En-Bresse (01000)

breadcrumbstring

Breadcrumb navigation path indicating the listing's category and location on PAP

priceinteger

Listed price of the property

currencystring

Currency of the listed price

refstring

PAP reference number for the listing. Example: G02/1580

publication_datedatetime

Date the listing was published on PAP. Example: 2026-03-20

image_urlsstring

List of property image URLs from the listing. Example: https://cdn.pap.fr/photos/pap/84/e6/84e6846cf2588b1ddd8c4422e93eb447/8-p1.jpg, https://cdn.pap.fr/photos/pap/8e/96/8e96e04a6f71b9d765f776a622bfc7a8/8-p1.jpg, https://cdn.pap.fr/photos/pap/ac/b6/acb6e93116c4f857f08d4110ad95ca99/a-p1.jpg, https://cdn.pap.fr/photos/pap/36/59/36592cba805e27d997e3be34489a9133/3-p1.jpg, https://cdn.pap.fr/photos/pap/e2/ae/e2ae8afbecf9b31e4139ecbb8d578158/e-p1.jpg, https://cdn.pap.fr/photos/pap/9d/b7/9db7715952cd1b323d0246c6d867a84b/9-p1.jpg

roomsinteger

Total number of rooms in the property. Example: 5

bedroomsinteger

Number of bedrooms in the property. Example: 3

sizeinteger

Living surface area of the property in square metres

neighborhoodstring

Neighborhood or locality where the property is located. Example: Bourg-en-Bresse (01000)

descriptionstring

Full description text provided by the seller on PAP. Example: Maison à vendre dans le quartier des Vennes en face de l'école des Vennes de 100 m² avec un appartement indépendant en dessous de 22 m² indépendant. La maison à 3 chambres de 11 à 13 m² chacune + une cuisine de 13 m² avec cuisine incorporée une grande salle a manger salon avec beau parquet de 41 m² avec accès sur balcon de 7 m² avec volet roulant électrique. Salle de bain de 5 m² refaites à neuf avec douche italienne de juillet 2025 aménagée qui peut convenir pour personne âgée... / wc séparé. Grande cave sous presque toute la maison avec plusieurs pièces qui peuvent très bien être aménagées comme pièces de vie même si la hauteur ne permet pas que ces dernières soient considérées comme des pièces de vie mais aucun souci pour les aménager comme tel si besoin, elles sont pourvue de plusieurs placards de rangements...

phonestring

Contact phone number of the seller. Example: 06 12 02 24 61

energystring

Energy performance class of the property (DPE rating, e.g. A to G). Example: E

gesstring

Greenhouse gas emissions class of the property (GES rating, e.g. A to G). Example: E

latstring

Latitude coordinate of the property. Example: 46.189715

lngstring

Longitude coordinate of the property. Example: 5.228885

price_per_sqminteger

Price per square metre as computed by PAP. Example: 2459

produitstring

Transaction type for the listing. Example: vente, location

typebienstring

Property type as a lowercase slug. Example: appartement, maison

typebien_labelstring

Property type in display form as shown on PAP. Example: Appartement

energy_descriptionstring

Full sentence describing the energy performance (DPE) class. Example: Logement très peu performant

ges_descriptionstring

Full sentence describing the greenhouse gas emissions (GES) class. Example: Émissions très élevées

transportsstring

Nearby public transit stations and their lines.

visite_virtuellestring

URL of the listing's virtual tour, if any.

exclusiveboolean

Whether the listing is marked as PAP-exclusive.

has_emailboolean

Whether the owner can be contacted by email (some owners accept phone contact only).

prix_valideboolean

Whether PAP independently validated the listing's asking price.

affiche_demarchage_refuseboolean

Whether the owner's listing shows the "refuses commercial canvassing" flag.

appel_videoboolean

Whether the owner offers a WhatsApp video-call viewing option.

videostring

URL of the listing's YouTube video, if any.

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 27227,
      "object": "result",
      "squid": "ef94be05b736ba2a22478b3bd5b48617",
      "run": "d1cb411736760627050af20746043c69",
      "internal_id": "460201580",
      "url": "https://www.pap.fr/annonces/maison-bourg-en-bresse-01000-r460201580",
      "title": "Vente maison 122 m² Bourg-En-Bresse (01000)",
      "breadcrumb": null,
      "price": null,
      "currency": null,
      "ref": "G02/1580",
      "publication_date": "2026-03-20",
      "image_urls": [
        "https://cdn.pap.fr/photos/pap/84/e6/84e6846cf2588b1ddd8c4422e93eb447/8-p1.jpg",
        "https://cdn.pap.fr/photos/pap/8e/96/8e96e04a6f71b9d765f776a622bfc7a8/8-p1.jpg",
        "https://cdn.pap.fr/photos/pap/ac/b6/acb6e93116c4f857f08d4110ad95ca99/a-p1.jpg"
      ],
      "rooms": 5,
      "bedrooms": 3,
      "size": null,
      "neighborhood": "Bourg-en-Bresse (01000)",
      "description": "Maison à vendre dans le quartier des Vennes en face de l'école des Vennes de 100 m² avec un appartement indépendant en dessous de 22 m² indépendant. La maison à 3 chambres de 11 à 13 m² chacune + une cuisine de 13 m² avec cuisine incorporée une grande salle a manger salon avec beau parquet de 41 m² avec accès sur balcon de 7 m² avec volet roulant électrique. Salle de bain de 5 m² refaites à neuf avec douche italienne de juillet 2025 aménagée qui peut convenir pour personne âgée... / wc séparé. Grande cave sous presque toute la maison avec plusieurs pièces qui peuvent très bien être aménagées comme pièces de vie même si la hauteur ne permet pas que ces dernières soient considérées comme des pièces de vie mais aucun souci pour les aménager comme tel si besoin, elles sont pourvue de plusieurs placards de rangements...",
      "phone": "06 12 02 24 61",
      "energy": "E",
      "ges": "E",
      "lat": 46.189715,
      "lng": 5.228885,
      "price_per_sqm": 10417,
      "produit": "vente",
      "typebien": "appartement",
      "typebien_label": "Appartement",
      "energy_description": "Logement avec une consommation annuelle d'énergie comprise entre 251 et 330 kWh/m²/an.",
      "ges_description": "Logement avec une émission de gaz à effet de serre comprise entre 51 et 70 kgéqCO2/m²/an.",
      "transports": "Alexandra David-Néel (tram-0, tram-3a); Porte de Vincennes (metro-0, metro-1, tram-0, tram-3b, tram-3a)",
      "visite_virtuelle": "https://my.matterport.com/show/?m=3RoVyvrsNMq&brand=0",
      "exclusive": false,
      "has_email": true,
      "prix_valide": false,
      "affiche_demarchage_refuse": true,
      "appel_video": false,
      "video": "https://www.youtube.com/watch?v=BHYfsB3y4n8",
      "functions": null,
      "native_id": 27227
    }
  ],
  "next": null,
  "previous": null
}