# PAP Real Estate Listings Scraper

> PAP Real Estate Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured real estate listing data from PAP (De Particulier à Particulier) search result pages, returning property details like price, title, type, and transaction type.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/pap?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pap-real-estate-listings-scraper-38ae9c89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Vkptre0jMP1iWPo8Tx0nt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pap-real-estate-listings-scraper-38ae9c89 -d '<json body>'
```

Example prompt: Scrape up to 50 apartment-for-sale listings from this PAP search URL — https://www.pap.fr/annonce/ventes-appartements-paris-75g439-g440 — and give me back the structured data including price, title, and property type.

## When to prefer this

Choose this endpoint when you need structured real estate listing data specifically from PAP.fr (the French peer-to-peer property platform), especially when you need to paginate through many results and want clean JSON output with property type and transaction type fields. Prefer this over generic web scrapers when you want reliable, schema-validated PAP data with pay-only-on-success pricing.

## Known failure modes

- Empty results if the PAP search URL is malformed or returns no listings
- Partial results if maxPages or maxItems limit is reached before all listings are collected
- HTTP errors if PAP.fr blocks or rate-limits the scraper
- Invalid input if startUrl is not a valid PAP search results URL

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of items found, the product identifier ('pap'), and an array of listing objects each containing: id, url, price, currency, title, description, propertyType, and transactionType. Failed or empty runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Stop after this many unique listings. Use 0 for no item cap."
  },
  "maxPages": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum number of paginated result pages to visit."
  },
  "startUrl": {
   "type": "string",
   "description": "Full PAP search results URL with your chosen location, transaction, property type, and filters."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "price": null,
    "title": null,
    "currency": null,
    "description": null,
    "propertyType": null,
    "transactionType": null
   }
  ],
  "product": "pap"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pap-real-estate-listings-scraper-38ae9c89/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)