Skip to main content
This guide shows how to scrape your first URL using Web Unlocker.

​
Prerequisites

​
Authentication

All requests require your API key in the apikey header: 
apikey: YOUR_API_KEY
The base URL for all API requests is: 
https://parsing.webunlocker.gologin.com/v1

​
Make your first request

Send a GET request with the target URL as a query parameter. The response is the fully rendered HTML of the page.

​
cURL

curl "https://parsing.webunlocker.gologin.com/v1/scrape?url=https%3A%2F%2Fexample.com" \
  -H "apikey: YOUR_API_KEY"

​
Python

import requests

response = requests.get(
    "https://parsing.webunlocker.gologin.com/v1/scrape",
    params={"url": "https://example.com"},
    headers={"apikey": "YOUR_API_KEY"}
)

print(response.text)

​
JavaScript (Node.js / Browser)

const response = await fetch(
  "https://parsing.webunlocker.gologin.com/v1/scrape?url=" +
    encodeURIComponent("https://example.com"),
  { headers: { apikey: "YOUR_API_KEY" } }
);

const html = await response.text();
console.log(html);

​
What you get back

The response body is the raw rendered HTML of the page — the same content you’d see if you opened the URL in a browser. No JSON wrapper, no parsing needed. 
<!DOCTYPE html>
<html>
  <head><title>Example Domain</title></head>
  <body>...</body>
</html>

​
Handling errors

Check the HTTP status code before processing the response:
StatusMeaning
200Success — response body is the page HTML
401Invalid or missing API key
422Invalid or missing URL parameter
429Rate limit exceeded
500 / 503Server error — retry with backoff
response = requests.get(
    "https://parsing.webunlocker.gologin.com/v1/scrape",
    params={"url": "https://example.com"},
    headers={"apikey": "YOUR_API_KEY"}
)

if response.status_code == 200:
    html = response.text
else:
    print(f"Error {response.status_code}: {response.text}")