Skip to content
Concepts

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
  }
}
typestring

Follows 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).

codestring

What happened, exactly: the list below.

messagestring

What to do, in a sentence a person or an agent can follow.

paramstring

The option at fault, as options.place, or null.

retryable, retry_afterboolean, integer

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

timeout408retryable

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.

concurrency_limit429retryable

Your plan's calls at a time are all running: Limits.

internal_error500retryable

Something broke on our side: retry, and quote the request_id if it happens again.

Your balance could not be read: nothing ran, retry in a few seconds.

Your connected accounts could not be read: nothing ran, retry in a few seconds.

service_busy503retryable

Too many calls at once on your account: retry in a few seconds.

Connected accounts

When POST /v2/accounts connects an account (Accounts):

The site did not accept these cookies, or they hold no login: copy them again from a browser where you are logged in.

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.

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

From google_maps/places/get, realtor/listings/search.

X has no profile with this handle (not charged).

From x/profiles/get, x/tweets/list.

X does not show this profile, suspended or withheld (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.

From google_maps/reviews/list, leboncoin/listings/search.

An edition is COUNTRY:language, as Google News writes it: US:en, FR:fr.

From google_news/articles/search.

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.

From google_maps/places/get, google_maps/reviews/list.

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.

From google_news/articles/search, x/tweets/search.

site is a domain: reuters.com.

From google_news/articles/search.

when takes 1h, 1d or 7d; after and before are days (YYYY-MM-DD); not when with them.

From google_news/articles/search.

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.

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.

blocked503retryable

LaCentrale refused this request. Retry later; failed calls are free.

From lacentrale/listings/check, lacentrale/listings/get.

ip_blocked503retryable

LaCentrale refused the attempted IPs. Retry later; failed calls are free.

From lacentrale/listings/check, lacentrale/listings/get.

site_unavailable503retryable

Google did not answer in time or refused the call; retry later (not charged).

Every operation.