# Leboncoin Listings Search

> Leboncoin Listings Search is a paid API for AI agents from api.x-402.online, paid per call via x402, $0.020002/call, status unknown (last checked 2026-10-20).

Searches Leboncoin (France's largest classifieds marketplace) by keyword, category, and location, returning structured listing data via residential French IP to bypass anti-datacenter blocks.

## Facts

- Endpoint: POST https://api.x-402.online/v1/fr/leboncoin?utm_source=zero.xyz
- Price: $0.020002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/leboncoin-listings-search-dd5be530
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-WqcApL34o7-Dbll84KD3

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-listings-search-dd5be530 -d '<json body>'
```

Example prompt: Search Leboncoin for second-hand mountain bikes listed in Lyon under 300 euros — show me the titles, prices, and links.

## When to prefer this

Use this endpoint when you need to programmatically search Leboncoin — the dominant French classifieds platform — and Leboncoin's anti-bot measures block direct datacenter requests. It is the right choice when you need structured listing data (title, price, location, date, URL) from French classified ads without maintaining your own residential proxy infrastructure. Prefer this over generic web scrapers when targeting Leboncoin specifically, since the residential French IP routing is purpose-built for this site.

## Known failure modes

- Keyword returns no results — empty listings array
- Leboncoin changes page structure, breaking extraction
- Residential IP session temporarily flagged or rate-limited
- Invalid or unsupported category parameter causes empty response
- Location name not recognized by Leboncoin, returning nationwide results
- Network timeout if Leboncoin is slow to respond through residential proxy

## How this service works

Pay-per-call APIs for AI agents — x402 protocol, USDC on Base, no account needed.

## Output

Returns structured data for each matching Leboncoin listing, including: listing title, asking price, geographic location, publication date, and direct URL to the listing page. Results are fetched via a real French residential browser session to ensure access to the site.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ads": [
   {
    "id": "2812345678",
    "url": "https://www.leboncoin.fr/ad/...",
    "city": "Bordeaux",
    "price": 420,
    "title": "iPhone 13"
   }
  ],
  "count": 20,
  "total": 1240,
  "source": "leboncoin.fr"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/leboncoin-listings-search-dd5be530/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x-402.online](https://www.zero.xyz/host/api.x-402.online/llms.txt)