# Leboncoin: Get a seller's phone number

`leboncoin/phones/get` · version 1.0.2 · pilot · 6 credits a call

The phone number a seller shows on one leboncoin.fr listing, read with a connected Leboncoin account.

Categories: Lead generation, Real estate, Cars

## When to use

You have a listing that shows a phone (`has_phone` in leboncoin/listings/search) and need the seller's number. A listing without the "Voir le numéro" button has none: do not ask for it. One call reads one listing, and each connected account reads about one number a minute: a busy account answers at once with `retry_after`, the seconds until its next slot.

## Call

```bash
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"source": "leboncoin", "operation": "phones/get", "options": {"listing": "3000000001", "account": "acc_7Hq2Kd"}}'
```

The answer's `next` is the whole call for the following page: send it as it is. `null` on the last page.

Beside `options`, the call takes:

| Parameter | Type | Description |
|---|---|---|
| `fields` | array of string | The record fields to keep, by path (`title`, `address.city`); `object`, `id` and `position` always come. Left out: every field. |

## Options

| Option | Type | Required | Default | Description |
|---|---|---|---|---|
| `listing` | string | yes |  | The listing's id, or its URL as it appears in the browser. |
| `account` | string |  |  | The connected Leboncoin account to read with (GET /v2/accounts). Left out, the platform takes the first of your Leboncoin accounts with a free slot. |

## Record

Each item of `results`. Every field is always present, `null` when the site gives nothing.

| Field | Type | Description |
|---|---|---|
| `object` | `"phone"` |  |
| `listing_id` | string | Leboncoin's listing id. |
| `listing_url` | string | null (uri) | The listing's address when it was given as a URL; null for an id alone (it does not say the category). |
| `phone` | object |  |
| `phone.status` | `found`, `none` | found; none when Leboncoin gave no number: the listing has no "Voir le numéro" button (a seller who does not want calls shows none, `has_phone` false), or it is no longer online. Leboncoin answers both the same way; whether a listing is still online is leboncoin/listings/check's question. |
| `phone.number` | string | null | The seller's own number, E.164 (+33...). |
| `phone.tracking_number` | string | null | The relay number Leboncoin shows instead when the seller has call tracking (a call to it reaches the seller and is counted for them), E.164; null when the listing shows the seller's own number. |
| `phone.is_mobile` | boolean | null |  |
| `account` | string | The connected account the number was read with. |
| `source_url` | string (uri) | The page these values were read from. |
| `observed_at` | string (date-time) | When they were read |

Example:

```json
{
  "object": "phone",
  "listing_id": "3000000001",
  "listing_url": "https://www.leboncoin.fr/ad/locations/3000000001",
  "phone": {
    "status": "found",
    "number": "+33600000000",
    "tracking_number": null,
    "is_mobile": true
  },
  "account": "acc_7Hq2Kd",
  "source_url": "https://www.leboncoin.fr/ad/locations/3000000001",
  "observed_at": "2026-11-09T09:12:44Z"
}
```

## Price



## Errors

| Code | Status | Retry | Message |
|---|---|---|---|
| `invalid_listing` | 422 | no | The value is neither a leboncoin.fr listing id nor a listing URL. |
| `account_required` | 422 | no | You have no connected Leboncoin account. Connect one with POST /v2/accounts {"site": "leboncoin", "cookies": ...}, the cookies of a browser where you are logged in to Leboncoin (https://docs.lobstr.io/accounts). |
| `account_rate_limited` | 429 | yes | Your Leboncoin accounts are paced at about one call a minute; `retry_after` says when the next slot opens. Retrying before then gets this same answer: nothing is queued. |
| `account_quota_exceeded` | 429 | yes | Your Leboncoin accounts reached their calls for today; `retry_after` says when the day starts over (midnight UTC). |
| `account_unusable` | 409 | no | Leboncoin logged this account out. Connect it again with POST /v2/accounts and fresh cookies from a browser where you are logged in (the same login keeps its id). |
| `site_challenge` | 503 | yes | Leboncoin asked this account to prove it is a person. Open leboncoin.fr in the browser the account syncs from, then retry (not charged). |
| `site_unavailable` | 503 | yes | Leboncoin did not answer in time; retry later (not charged). |
| `missing_api_key` | 401 | no | No API key: send it as `Authorization: Bearer <key>`. |
| `invalid_api_key` | 401 | no | The key is not valid, or not anymore. |
| `insufficient_credits` | 402 | no | The call costs more credits than are left. |
| `unknown_operation` | 404 | no | No such source and operation in the catalog. |
| `timeout` | 408 | yes | The call did not finish within its deadline (not charged). |
| `invalid_body` | 422 | no | The body is not a call: source, operation, options. |
| `invalid_options` | 422 | no | An option is missing or out of its contract; `param` names it. |
| `invalid_idempotency_key` | 400 | no | The Idempotency-Key header is not printable ASCII, or too long. |
| `concurrency_limit` | 429 | yes | The plan's calls at a time are all in progress (Free 1, Starter 2, Pro 10, Team 50); retry when one has finished (not charged, never queued). |
| `service_busy` | 503 | yes | Too many calls at once on the account; retry in a few seconds. |
| `balance_unavailable` | 503 | yes | The balance could not be read; retry in a few seconds. |

## Changelog

- **1.0.2** (2026-11-02): A listing no longer online that Leboncoin answers with a 410 reads phone.status none too (it read as site_unavailable). Leboncoin's anti-bot page is recognized by its content whatever its status (403, 404, 202), so a blocked call is never read as a listing without a number.
- **1.0.1** (2026-11-02): A listing without the "Voir le numéro" button, or no longer online, reads phone.status none (free) instead of the error listing_not_found: Leboncoin answers both the same way, and a listing without a number was said removed when it was not.
- **1.0.0** (2026-11-02): First version on the API v2.

Schema: https://api.lobstr.io/v2/catalog/leboncoin/phones/get · All operations: https://api.lobstr.io/v2/catalog.md
