Error codes
When something fails, the receipt has status: "failed" and a failure with a
code and a message. The attempts list shows every tool that was tried.
Fetching
Section titled “Fetching”| Code | What happened | Try |
|---|---|---|
BLOCKED |
The site refused (HTTP 403) | A stealth browser, or your login |
RATE_LIMITED |
Too many requests (HTTP 429) | Wait, or another tool |
CAPTCHA |
A “verify you are human” page | A stealth browser or CAPTCHA add-on |
AUTH_REQUIRED, AUTH_EXPIRED |
You need to be logged in (HTTP 401) | Use or refresh a login |
NOT_FOUND |
The page is gone (HTTP 404 or 410) | Doesn’t mean it sold; check the listing |
PROVIDER_DOWN |
The site or tool had a server error | Try again, or another tool |
VISUAL_REQUIRED |
The page is empty without JavaScript | Use render=True |
CONTENT_MISMATCH |
The page isn’t the item you asked for | Check the URL |
SCHEMA_CHANGED |
The site parser’s checks failed | The site changed; the parser needs fixing |
TIMEOUT |
It took too long | Raise the timeout, or another tool |
LIMIT_EXCEEDED |
The page was too big | Raise max_bytes |
INVALID_URL |
The URL isn’t valid | Fix the URL |
INVALID_IMAGE |
A photo didn’t decode | Only that photo fails; the rest still return |
SEARCH_UNAVAILABLE |
No results, and the search engines failed | Another source |
Tools and settings
Section titled “Tools and settings”| Code | What happened | Try |
|---|---|---|
PROVIDER_UNAVAILABLE |
That tool isn’t installed or set up | Install it, for example install-public-providers.sh |
POLICY_DENIED |
Your settings don’t allow any tool for this | Change the settings |
UNKNOWN |
Something else went wrong | Look at the trace |
Logins
Section titled “Logins”| Code | What happened |
|---|---|
IDENTITY_REQUIRED |
You asked for your Chrome without naming a login |
IDENTITY_UNKNOWN, IDENTITY_REVOKED |
That login isn’t registered, or was removed |
IDENTITY_EXECUTOR_OFFLINE, IDENTITY_EXECUTOR_UNKNOWN, IDENTITY_EXECUTOR_DISABLED |
The Chrome for that login isn’t available |
IDENTITY_PROFILE_MISMATCH, IDENTITY_CHANGED |
Chrome isn’t using the registered profile, or it changed |
IDENTITY_IN_USE |
Another request is using that login right now |
IDENTITY_REAUTH_REQUIRED |
You’ve been logged out; log in again |
IDENTITY_DOMAIN_DENIED, IDENTITY_PROVIDER_DENIED, IDENTITY_ACTION_DENIED, IDENTITY_POLICY_DENIED |
The login isn’t allowed for that site, tool or action |
IDENTITY_SCRIPT_REQUIRED |
The page needs JavaScript, which logged-in reads don’t run yet |
IDENTITY_AUTHORITY_UNSUPPORTED |
That login type isn’t supported yet (only LOCAL_ONLY is) |
IDENTITY_CONFIG_INVALID, IDENTITY_REGISTRY_INVALID, IDENTITY_STORE_UNSAFE |
Problem with the login settings or file permissions |
Saved secrets
Section titled “Saved secrets”| Code | What happened |
|---|---|
VAULT_REFERENCE_INVALID, VAULT_REFERENCE_MISSING |
A saved secret’s name is wrong or missing |
VAULT_VALUE_INVALID |
A saved secret couldn’t be read |