Skip to content
2026

November 4, 2026

Errors that say what to do, with the fields an agent needs

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
November 4, 2026

Errors that say what to do, with the fields an agent needs

Improved

Error responses carry structured hints

Some errors now add fields to the errors object, next to message, type and code, which do not change. A client that ignores them keeps working.

  • InvalidParam on a setting the crawler does not have: when another crawler of the same site has it, the message says so ("Unknown parameter: phone. Did you mean functions.get_phone_numbers on leboncoin-iter-listings-with-phone?") and the response adds param and suggestion, with the crawler id and the param to send there. See Update Squid.
  • TaskNotValidError: the message shows the value received and the crawler's own example ("The 'url' format is not valid for facebook-group-posts-scraper: got https://www.facebook.com/somepage. Expected something like https://www.facebook.com/groups/211270969394435/"), and the response adds param and example. See Add Tasks.
  • DuplicateSquid: squid names are unique per account. The message names the squid ("A squid named Reviews already exists.") and the response adds squid, the id of the squid that has the name, to reuse it instead of creating it again. See Create Squid.
{
  "errors": {
    "message": "Unknown parameter: phone. Did you mean functions.get_phone_numbers on leboncoin-iter-listings-with-phone?",
    "type": "InvalidParam",
    "code": 400,
    "param": "phone",
    "suggestion": { "crawler": "7bc4acdb18f2b90fdd5eb42b8e8251e9", "param": "functions.get_phone_numbers" }
  }
}

Fixed

Leboncoin Listings & Phone Search Export: no phone alias

The settings page said the old function name phone was still accepted. It is not: use functions.get_phone_numbers. See Update Settings.