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.2When 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.
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.
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" } }'
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
listingstringrequiredaccountstringRecord
Each record of results, in the envelope every call returns (Run an operation).
objectstringlisting_idstringlisting_urlstringphone.statusstringhas_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.numberstringphone.tracking_numberstringphone.is_mobilebooleanaccountstringsource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_listing | 422 | The value is neither a leboncoin.fr listing id nor a listing URL. |
account_required | 422 | 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 | 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. Retryable. |
account_quota_exceeded | 429 | Your Leboncoin accounts reached their calls for today; retry_after says when the day starts over (midnight UTC). Retryable. |
account_unusable | 409 | 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 | Leboncoin 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_unavailable | 503 | Leboncoin 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-021.0.12026-11-021.0.02026-11-02