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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringPublic URL to load inside BrowserSolver's headless browser. Include http:// or https://.
Example:
https://quotes.toscrape.com/js/Pick a tier:
- HTML already in the response: try Website Crawler first (1 credit).
- JavaScript required: Website Rendering (this endpoint).
- Still blocked on an approved domain: Website WebUnlocker.
Guide: fetch tier comparison.
wait_in_seconds?numberExtra 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.
0 <= value <= 30"0"wait_for?stringCSS 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-readyblock_ads?booleanSkip 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.
falsetimeout?numberHard 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_forso critical nodes appear before the ceiling.
"30"fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
response?stringapplication/jsoncurl -X GET 'https://api.browsersolver.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>"