Skip to content
Leboncoin

Get a seller's phone number

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

leboncoin/phones/get6 credits a callv1.0.2

When to use it

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.

It runs with one of your own Leboncoin accounts, connected once: Accounts.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
The listing's id, or its URL as it appears in the browser.
The connected Leboncoin account to read with (GET /v2/accounts).
6 credits a call
Code, from the fields above
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"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_ruf5tk7vipix34vusie5coqwum",
  "livemode": true,
  "source": "leboncoin",
  "operation": "phones/get",
  "version": "1.0.2",
  "schema_url": "https://api.lobstr.io/v2/catalog/leboncoin/phones/get",
  "options": {
    "listing": "3000000001",
    "account": "acc_7Hq2Kd"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": false,
  "next": null,
  "cost": {
    "credits": 6
  },
  "results": [
    {
      "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"
    }
  ]
}

Options

listingstringrequired
The listing's id, or its URL as it appears in the browser.
accountstring
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 record of results, in the envelope every call returns (Run an operation).

objectstring
listing_idstring
Leboncoin's listing id.
listing_urlstring
The listing's address when it was given as a URL; null for an id alone (it does not say the category).
phone.statusstring
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.numberstring
The seller's own number, E.164 (+33...).
phone.tracking_numberstring
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_mobileboolean
accountstring
The connected account the number was read with.
source_urlstring
The page these values were read from.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_listing422The value is neither a leboncoin.fr listing id nor a listing URL.
account_required422You 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_limited429Your 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. Retryable.
account_quota_exceeded429Your Leboncoin accounts reached their calls for today; retry_after says when the day starts over (midnight UTC). Retryable.
account_unusable409Leboncoin 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_challenge503Leboncoin asked this account to prove it is a person. Open leboncoin.fr in the browser the account syncs from, then retry (not charged). Retryable.
site_unavailable503Leboncoin did not answer in time; retry later (not charged). Retryable.

Price

6 credits a call. A failed call is free. What a credit costs on each plan: Credits and pricing.

Each connected account makes one call every 60 seconds, plus 15 to 30 seconds and 300 a day; a busy account answers at once with account_rate_limited and retry_after.

Changelog

1.0.22026-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.12026-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.02026-11-02
First version on the API v2.