# Leboncoin Listing Scraper

> Leboncoin Listing 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 listing data from leboncoin.fr search results or individual ad pages, returning paginated item details including title, category, description, and status.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/leboncoin?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/leboncoin-listing-scraper-4e18fad4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aDAbUuVg2bW_hI4x6K9yF

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 leboncoin-listing-scraper-4e18fad4 -d '<json body>'
```

Example prompt: Search leboncoin.fr for second-hand road bikes in Paris — scrape up to 3 pages of results and give me structured data on each listing including title, category, and description.

## When to prefer this

Use this endpoint when you need structured, paginated data from leboncoin.fr specifically — France's largest classifieds platform — and want pay-per-successful-call pricing so failed or empty runs cost nothing. Prefer this over generic web scrapers when you need clean JSON output without managing scraping infrastructure.

## Known failure modes

- Empty results if the search URL yields no listings or leboncoin blocks the request
- Invalid or malformed startUrls causes a failed run (not charged)
- maxPages exceeding site limit (100) is capped automatically
- Rate limiting or anti-bot measures from leboncoin.fr may return empty results
- Incorrect URL format (non-leboncoin.fr URLs) will fail silently or return error

## 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, a product label ('leboncoin'), and an array of listing objects each containing id, url, title, status, category, categoryId, description, and listingType fields. Empty or failed runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum saved listings across all URLs. Set 0 for no item cap; the site limits each search to 100 result pages."
  },
  "maxPages": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum result pages to read for each search URL. Each page contains up to 35 listings; the site exposes at most 100 pages per search."
  },
  "startUrls": {
   "type": "array",
   "description": "HTTPS leboncoin.fr search URLs across public categories or direct /ad/ listing URLs. Search parameters are sent to the site’s structured page data route."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "title": null,
    "status": null,
    "category": null,
    "categoryId": null,
    "description": null,
    "listingType": null
   }
  ],
  "product": "leboncoin"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/leboncoin-listing-scraper-4e18fad4/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)