Skip to main content
GET
https://api.crawleo.dev
/
headful-browser
Headful Browser API
curl --request GET \
  --url https://api.crawleo.dev/headful-browser \
  --header 'x-api-key: <x-api-key>'
{
  "data": [
    {
      "url": "<string>",
      "content": "<string>",
      "raw_html": "<string>",
      "enhanced_html": "<string>",
      "markdown": "<string>",
      "page_text": "<string>",
      "screenshot": "<string>",
      "blocked": true
    }
  ]
}

​
Overview

The Headful Browser API provides high-fidelity crawling using a real browser (headful mode) with SOAX proxies. It is ideal for scraping sites that require full browser context, advanced anti-bot evasion, or screenshot capture.

​
Endpoint

GET https://api.crawleo.dev/headful-browser

​
Parameters

​
Required Headers

​
x-api-key
string
required
Your Crawleo API key for authentication.Example: x-api-key: YOUR_API_KEY

​
Required Parameters

​
urls
string
required
One or more URLs to crawl. Accepts a comma-separated string or array.Example: urls=https://example.com,https://example.org

​
Optional Parameters

​
country
string
ISO country code for proxy geolocation (e.g., us, gb).
​
output_format
string
default:"raw_html"
Output format: raw_html, enhanced_html, markdown, page_text.
​
screenshot
boolean
default:"false"
Set to true to capture a screenshot.

​
Example Request

cURL
curl -X GET "https://api.crawleo.dev/headful-browser?urls=https://example.com&output_format=markdown&screenshot=true" \
  -H "x-api-key: YOUR_API_KEY"

​
Response

A successful response returns an array of results: 
{
  "status": "success",
  "data": [
    {
      "url": "https://example.com",
      "content": "<html>...</html>",
      "raw_html": "...",
      "enhanced_html": "...",
      "markdown": "...",
      "page_text": "...",
      "screenshot": "https://...",
      "blocked": false
    }
  ]
}
​
data
array
Array of result objects for each URL.

​
Notes

  • Use for sites requiring full browser context or advanced anti-bot evasion.
  • Each request costs 50 credits.
  • For most static sites, use the standard Crawl API for lower cost.
Last modified on April 14, 2026