Skip to content
Help Center Screenshots Custom HTTP Headers and Request Options

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