BrowserSolver

Website Rendering

GET
/v1/website/rendering

Run a managed browser session against a public URL and collect the HTML after client-side scripts finish. Prefer Crawler for static markup; escalate to WebUnlocker on approved hosts when challenges persist.

Credit cost: 2 credits per call

Autorisierung

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Abfrageparameter

query*string

Public URL to load inside BrowserSolver's headless browser. Include http:// or https://.

Example:

https://quotes.toscrape.com/js/

Pick a tier:

Guide: fetch tier comparison.

wait_in_seconds?number

Extra pause, in seconds, after the page load event before BrowserSolver returns HTML. Helpful when widgets animate or hydrate late.

Note: every extra second adds latency to the call. Keep this low unless the page needs it.

Range0 <= value <= 30
Default"0"
wait_for?string

CSS or XPath selector that must appear in the DOM before HTML is returned. The managed browser waits until the node exists (or until timeout).

Supported shapes:

  • ID: #results-ready
  • Class: .product-grid
  • Combined: main#catalog .item

Example:

wait_for=#results-ready
block_ads?boolean

Skip ad-network requests while the page renders.

  • false: load ads as the site would (default)
  • true: drop ad traffic for cleaner HTML and faster renders

Note: useful on ad-heavy storefronts where creatives pollute the DOM.

Default"false"
timeout?number

Hard ceiling, in seconds, for the render session. When reached, BrowserSolver returns whatever HTML is available.

Notes:

  • Lower values may truncate slow pages.
  • Pair with wait_for so critical nodes appear before the ceiling.
Default"30"

Antworttext

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/website/rendering?query=string"
"<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"utf-8\"><title>Shipping faster with edge caches | Engineering Notes</title><script src=\"/assets/app.bundle.js\" defer></script></head><body><div id=\"root\" data-hydrated=\"true\"><article><h1>Shipping faster with edge caches</h1><p class=\"byline\">Published 2026-03-12</p><p>After hydration, product metrics and comments appear below.</p><section id=\"comments\" data-loaded=\"true\"><div class=\"comment\">Nice write-up.</div></section></article></div></body></html>"
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}