Screenshots
Custom HTTP Headers and Request Options
Pass custom HTTP headers, cookies, a Referer, User-Agent string, or POST data with your screenshot request.
Custom headers
Pass additional HTTP request headers to the captured page. Each header is a JSON object; provide one per line:
{
"url": "https://example.com",
"header": [
{"X-Request-Id": "abc123"},
{"Authorization": "Bearer token"}
]
}
Referer
Set the HTTP Referer header to simulate navigation from another URL. Useful for pages that enforce hotlinking protection:
{
"url": "https://example.com",
"referer": "https://google.com/"
}
User-Agent
Override the browser's default User-Agent string to test bot-detection or device-specific layouts:
{
"url": "https://example.com",
"user_agent": "Mozilla/5.0 (compatible; MyBot/1.0)"
}
Cookie
Pass pre-set cookies in name=value format (semicolon-separated), useful for bypassing consent walls or setting session cookies:
{
"url": "https://example.com",
"cookie": "session_id=abc123; consent=true"
}
POST data
The post_data field sends the URL as a POST request with the given body, instead of a standard GET request.
Last updated March 27, 2026