Errors
One error object for every failure, with what to do. A failed call costs nothing.
{ "error": { "type": "authentication_error", "code": "missing_api_key", "message": "Send your API key as `Authorization: Bearer <key>`; it is on https://app.lobstr.io/dashboard/api", "param": null, "doc_url": "https://docs.lobstr.io/errors#missing_api_key", "request_id": "req_t7nhs6wqq5bojctezxhjqjf45e", "retryable": false } }
typestringFollows the HTTP status, to branch on: invalid_request_error (400, 404, 409, 410, 422), authentication_error (401), billing_error (402), rate_limit_error (429), site_error (408, 424, 503), api_error (500).
codestringWhat happened, exactly: the list below.
messagestringWhat to do, in a sentence a person or an agent can follow.
paramstringThe option at fault, as options.place, or null.
retryable, retry_afterboolean, integerWhether the same call can work later, and in how many seconds (also in the Retry-After header).
Nothing is charged for a call that fails, whoever's fault it is.
Every call
No Authorization header: send Authorization: Bearer <key>.
The key was mistyped or changed: copy it again from the app.
The call costs more credits than are left. The message says both; plans.
No such operation on this source: GET /v2/catalog?source=... lists them.
The site did not answer in time. Retry, or raise timeout_s up to the operation's maximum.
This Idempotency-Key was used with another body: use a new key for a new call.
The first call with this key still runs: retry with the same key in a few seconds.
The body is not what POST /v2/run takes; param says where.
An option does not fit the operation's contract; param names it, the message says what it takes.
A field asked in fields is not in the records; the message lists those that are.
limit out of its range (1 to 100 on GET /v2/runs), or sent to an operation that answers one record.
Idempotency-Key takes 1 to 255 printable characters, no spaces; a UUID is fine.
Your plan's calls at a time are all running: Limits.
Something broke on our side: retry, and quote the request_id if it happens again.
Too many calls at once on your account: retry in a few seconds.
Connected accounts
When POST /v2/accounts connects an account (Accounts):
The country this call comes from could not be told: send country, the one you use the account from.
This site's accounts go out from one country (Leboncoin: FR): leave country out or send that one.
No connected account of yours has this id: GET /v2/accounts lists them.
Your calls
When GET /v2/runs reads them back (Run an operation):
No call of yours has this id; calls are kept 90 days.
This call's whole answer was not kept: a failed call answered its error only, and GET /v2/runs/{id} has it.
Your plan keeps answers 7, 45 or 90 days, and this one's time is over.
created_after and created_before take a date in UTC, as 2026-11-09T08:00:00Z.
status takes succeeded or failed.
via takes api, mcp or app.
An operation's own
Each operation lists its errors on its page; here they all are, each once.
Pass a LaCentrale listing reference, numeric id or listing URL.
From lacentrale/listings/check, lacentrale/listings/get, leboncoin/listings/check, leboncoin/listings/get, leboncoin/phones/get, realtor/listings/get, seloger/listings/get.
This profile's posts are protected: X shows them to its followers only, and your connected X account does not follow it (not charged).
From x/tweets/list.
LaCentrale says this listing is unavailable or does not exist.
From lacentrale/listings/get, leboncoin/listings/get, seloger/listings/get.
realtor.com knows no such listing (not charged).
From realtor/listings/get.
Google knows no such place (not charged).
X has no profile with this handle (not charged).
From x/profiles/get, x/tweets/list.
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).
From leboncoin/phones/get, x/profiles/get, x/tweets/list, x/tweets/search.
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).
From leboncoin/phones/get, x/profiles/get, x/tweets/list, x/tweets/search.
This name matches several places; choose one and send its id as place.
From google_maps/places/get.
This cursor was not given by an answer; send next from the last answer as it is.
An edition is COUNTRY:language, as Google News writes it: US:en, FR:fr.
max_pages takes 1 to 10.
From websites/contacts/get.
This place id or link does not say which place it is on Google's side; send its cid or its page's link.
Pass a profile's handle (nasa, @nasa) or its address (https://x.com/nasa).
From x/profiles/get, x/tweets/list.
query takes 1 to 500 characters.
Pass the continuation context unchanged from next, or omit search to start a new search.
site is a domain: reuters.com.
when takes 1h, 1d or 7d; after and before are days (YYYY-MM-DD); not when with them.
This is not a supported LaCentrale listing URL, or a filter or page is invalid.
From lacentrale/listings/search, leboncoin/listings/search, realtor/listings/search, seloger/listings/search.
The value is neither a website's address nor a domain.
From websites/contacts/get.
This listing is shown on another site than seloger.com (Belles Demeures, SeLoger Neuf). Not charged.
From seloger/listings/get.
Google answered in a shape we do not read yet; we are told and fix it, and it is not charged. Retrying now gives the same.
From google_maps/places/get, google_maps/places/search, google_maps/reviews/list, google_news/articles/search, lacentrale/listings/check, lacentrale/listings/get, lacentrale/listings/search, leboncoin/listings/check, leboncoin/listings/get, leboncoin/listings/search, realtor/listings/get, realtor/listings/search, seloger/listings/get, seloger/listings/search, x/profiles/get, x/tweets/list, x/tweets/search.
The website did not answer: its domain has no server, it refused the connection, or its home page is missing. Not charged.
From websites/contacts/get.
Your Leboncoin accounts reached their calls for today; retry_after says when the day starts over (midnight UTC).
From leboncoin/phones/get.
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.
From leboncoin/phones/get, x/profiles/get, x/tweets/list, x/tweets/search.
LaCentrale refused this request. Retry later; failed calls are free.
LaCentrale refused the attempted IPs. Retry later; failed calls are free.
Google asked to prove a person is there; retry in a minute (not charged).
From google_news/articles/search, lacentrale/listings/search, leboncoin/listings/check, leboncoin/listings/get, leboncoin/listings/search, leboncoin/phones/get, realtor/listings/get, realtor/listings/search, seloger/listings/get, seloger/listings/search.