Quickstart
Scrape a website with a single HTTP request using the Browserless REST APIs.
Sign Up
Sign up for a Browserless account (free plan available).
Get API Token
Get your API token from the account dashboard.
Run Your First Request
- cURL
- Node.js
- Python
curl -X POST "https://production-sfo.browserless.io/scrape?token=YOUR_API_TOKEN_HERE" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","elements":[{"selector":"h1"}]}'const response = await fetch(
'https://production-sfo.browserless.io/scrape?token=YOUR_API_TOKEN_HERE',
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
url: 'https://example.com',
elements: [{ selector: 'h1' }]
})
}
);
const data = await response.json();
console.log(data);import requests
response = requests.post(
'https://production-sfo.browserless.io/scrape?token=YOUR_API_TOKEN_HERE',
json={
'url': 'https://example.com',
'elements': [{'selector': 'h1'}]
}
)
data = response.json()
print(data)Response
{ "data": [ { "results": [ { "html": "Example Domain", "text": "Example Domain" } ], "selector": "h1" } ] }
FAQ & Troubleshooting
Why am I getting a 403 Forbidden response?
Your API token is missing or malformed. Pass it as a ?token= query parameter, not in the request body. Verify the token in your account dashboard.
Do I need Puppeteer or Playwright to use the REST APIs?
No. REST APIs are standalone HTTP endpoints. Send a POST request with your parameters and receive the result directly. No browser libraries, WebSocket connections, or SDKs required.