Skip to content

invalid_url

HTTP status: 400 Bad Request

  1. Prepend the scheme. example.com/pagehttps://example.com/page. We do not auto-prepend because guessing wrong silently is worse than failing loudly.
  2. URL-encode special characters. Spaces become %20, # becomes %23, etc. Most HTTP clients do this for you; raw shell command-lines often don't.
  3. Strip stray whitespace. A leading or trailing space breaks parsing. trim() the value before submitting.
  4. Reject private and link-local hosts. localhost, 127.0.0.1, 192.168.*, 10.*, 169.254.* are blocked by our SSRF guard and return this same code.

The URL string failed validation before we ever dispatched a scrape job. Either the format is wrong (no scheme, bad characters) or the target host is on our blocklist for SSRF reasons. The param field in the error body tells you which field failed — usually url, sometimes urls[3] for batch submits.

  • invalid_input — generic field-level validation failure for non-URL fields
  • invalid_workflow — the workflow JSON itself is malformed

Contact support with your request_id (looks like req_01HF3JKB...). Include the exact URL you submitted so we can reproduce.