Skip to content
Concepts

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:

OperationEach accountA day
leboncoin/phones/getOne call every 60 seconds, plus 15 to 30 seconds300 calls
x/profiles/getOne call every 2 seconds, plus 0 to 2 secondsNo cap of ours
x/tweets/listOne call every 2 seconds, plus 0 to 2 secondsNo cap of ours
x/tweets/searchOne call every 2 seconds, plus 0 to 2 secondsNo 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"
  }'
sitestringrequired

x or leboncoin: the sites an operation needs an account for.

cookiesobject | object[]required

The site's cookies, as {name: value} or a cookie editor's list of {name, value, domain}.

countrystring

The 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

okstatus

Ready.

pausedstatus

The site slowed it down: it comes back by itself at paused_until. Meanwhile, calls without account go to your other accounts.

expiredstatus

The 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.