/scrapers/*/*
POST/scrapers/*/*
Runs one API of a predefined scraper from the loaded scraper bundle: POST /scrapers/{scraper}/{api}, where {scraper} is the scraper name (an organisation slug such as zillow — never a hostname) and {api} is one of its APIs, both as listed by GET /scrapers.
The body is the API's input ({ url?, params? }). A scraper that runs and reports a typed scrape error (blocked, not-found, invalid-input, upstream-changed, upstream-error) still returns HTTP 200 with ok:false. HTTP 4xx/5xx is reserved for host-level failures (unknown scraper/api, bundle unavailable, overloaded, job timeout, worker crash, job drained by a bundle hot swap, invalid result). Every ok:true result has been validated against the API's declared output schema.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 429
- 500
- 503
The request contains errors or didn't properly encode content.
The request is missing, or contains bad, authorization credentials.
The request targets a destination that is not allowed.
Resource couldn't be found.
The request took has taken too long to process.
Too many requests are currently being processed.
An internal error occurred when handling the request.
Service is unavailable.