Skip to main content

​
Custom Headers

Set custom HTTP headers to modify how the target page behaves or responds.

​
Basic usage

bash
curl "https://api.domshot.com/shot?key=YOUR_API_KEY&url=https://example.com&customHeaders=%7B%22Accept-Language%22%3A%22en-US%22%7D" \
  --output screenshot.png

​
Multiple headers

bash
curl "https://api.domshot.com/shot?key=YOUR_API_KEY&url=https://example.com&customHeaders=%7B%22Accept-Language%22%3A%22en-US%22%2C%22Accept-Encoding%22%3A%22gzip%2C%20deflate%22%7D" \
  --output screenshot.png

​
Common use cases

Use caseExample header
Language preferenceAccept-Language: en-US
Content negotiationAccept: application/json
Custom authenticationAuthorization: Bearer token
Geographic targetingX-Forwarded-For: 1.2.3.4
Custom headers override browser defaults. Some headers like User-Agent have a dedicated parameter (see Custom User Agent).

​
Parameters

ParameterTypeDescription
customHeadersstringJSON object of HTTP headers

​
See also