Accounts
Some operations read what a site shows only to its members. They run with your own account on the site, connected once.
These operations need one of your accounts, and go at its pace:
| Operation | Each account | A day |
|---|---|---|
leboncoin/phones/get | One call every 60 seconds, plus 15 to 30 seconds | 300 calls |
x/profiles/get | One call every 2 seconds, plus 0 to 2 seconds | No cap of ours |
x/tweets/list | One call every 2 seconds, plus 0 to 2 seconds | No cap of ours |
x/tweets/search | One call every 2 seconds, plus 0 to 2 seconds | No cap of ours |
Only your own accounts: there is no pool of bought or shared ones, and nothing runs in a name you did not give us.
Connect one
Log in to the site in your browser, copy its cookies (a cookie editor's export works as it is), and send them:
curl https://api.lobstr.io/v2/accounts \ -H "Authorization: Bearer $LOBSTR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "site": "x", "cookies": { "auth_token": "...", "ct0": "..." }, "country": "FR" }'
sitestringrequiredx or leboncoin: the sites an operation needs an account for.
cookiesobject | object[]requiredThe site's cookies, as {name: value} or a cookie editor's list of {name, value, domain}.
countrystringThe country you use the account from, as FR or US. Left out, it is the country of the IP that sends this call: right from your browser, wrong from a server elsewhere, where you say it. Behind a VPN, it is the VPN's country. Leboncoin's accounts go out from France: leave it out.
The site checks the cookies at once, and the account is kept only once the site accepted them: 201 with the account. The same login sent again replaces its session and keeps its id (200). Cookies the site refuses answer invalid_cookies, and nothing is kept.
{ "object": "account", "id": "acc_7Hq2Kd9mX4pL", "site": "x", "name": "acme", "status": "ok", "country": "FR", "paused_until": null, "created_at": "2026-11-16T09:12:40.118Z", "last_used_at": null }
Use it
Pass its id as the operation's account option. Left out, the first of your accounts on that site with a free slot takes the call.
Every call of an account goes out from an IP of its country, kept for a while and never shared with another account at the same time: a session used from elsewhere looks stolen to the site. Its cookies are encrypted, never answered and never logged.
Its status
okstatusReady.
pausedstatusThe site slowed it down: it comes back by itself at paused_until. Meanwhile, calls without account go to your other accounts.
expiredstatusThe site logged it out: log in again in your browser and connect it again.
List, read, remove
GET /v2/accounts lists yours (?site=x for one site), GET /v2/accounts/{id} reads one, and DELETE /v2/accounts/{id} removes it, its session with it.