Back to catalog

Scrapingbee · Web Data

ScrapingBee API / Scrape a web page

Fetch any URL through ScrapingBee: headless browser rendering, premium or stealth proxies, CSS/XPath or AI extraction, markdown or text output, screenshots. jsonresponse is on by default so the answer is a JSON object with body, headers, cookies and evaluateresults. Cost on your ScrapingBee plan: 1 credit without JS, 5 with JS (default), 10 or 25 with premium proxy, 75 with stealth proxy. Failed requests (400, 401, 403, 429, 500) are not billed by ScrapingBee.

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • ai_extract_rules query · optional

    Stringified JSON describing the fields the AI should extract.

  • ai_query query · optional

    What to extract from the page in plain words (AI extraction).

  • ai_selector query · optional

    CSS selector to focus the AI extraction on.

  • block_ads query · optional

    Block ads.

  • block_resources query · optional

    Block images and CSS.

  • cookies query · optional

    Custom cookies, name=value pairs separated by ;.

  • country_code query · optional

    Two-letter country code for premium proxy geolocation, e.g. us, de.

  • device query · optional

    Device to emulate: desktop or mobile.

  • extract_rules query · optional

    Stringified JSON of CSS/XPath extraction rules, e.g. {"title":"h1"}.

  • forward_headers query · optional

    Forward your Spb- prefixed headers to the target.

  • js_scenario query · optional

    Stringified JSON scenario of browser actions to run before capture.

  • json_response query · optional

    Wrap the reply in JSON (body, headers, cookies, evaluate_results, screenshot). Kept on by default so the answer is JSON.

  • own_proxy query · optional

    Your own proxy URL to route through.

  • premium_proxy query · optional

    Use premium residential proxies (25 credits with JS, 10 without).

  • render_js query · optional

    Render JavaScript with a headless browser (5 credits). false = 1 credit.

  • return_page_markdown query · optional

    Return the page as markdown.

  • return_page_source query · optional

    Return the HTML before JavaScript rendering.

  • return_page_text query · optional

    Return the page as plain text.

  • screenshot query · optional

    Return a screenshot.

  • screenshot_full_page query · optional

    Return a full-page screenshot.

  • screenshot_selector query · optional

    CSS selector of the area to screenshot.

  • session_id query · optional

    Route requests through the same IP for 5 minutes (any integer).

  • stealth_proxy query · optional

    Use the stealth proxy pool (75 credits, needs JS rendering).

  • timeout query · optional

    Request timeout in milliseconds.

  • transparent_status_code query · optional

    Return the target page's own HTTP status code.

  • url query · required

    Full URL of the page to scrape, including the scheme.

  • wait query · optional

    Extra wait after render in milliseconds, 0 to 35000.

  • wait_browser query · optional

    Browser event to wait for: domcontentloaded, load, networkidle0, networkidle2.

  • wait_for query · optional

    CSS or XPath selector to wait for before returning.

  • window_height query · optional

    Viewport height in pixels.

  • window_width query · optional

    Viewport width in pixels.

No allowlisted official documentation or pricing reference is available.

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.