Skip to main content

Forward HTTP headers

You can add your custom headers to a request or force original browser headers to be removed. To remove a header, set its value to empty string.

Headers are passed as JSON in headers parameter:

{"x-custom-header": "value", "host": ""}

Remember to encode this parameter like in the example below.


In the example below, we add two headers:

  • Date: Wed, 24 Jan 2024 07:28:00 GMT,
  • X-Custom-Header: value.

These headers will be forwarded to the requested page.

import requests
import json

payload = {
"api_key": "[your API key]",
"url": "",
"headers": json.dumps(
{"date": "Wed, 24 Jan 2024 07:28:00 GMT", "x-custom-header": "value"}

response = requests.get("", params=payload)

In the response from, you will be able to validate that the desired headers were indeed included in the request:

"headers": {
"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
"Accept-Encoding": "gzip, deflate, br",
"Accept-Language": "en-US",
"Date": "Wed, 24 Jan 2024 07:28:00 GMT",
"Host": "",
"Sec-Ch-Ua": "\"Google Chrome\";v=\"107\", \"Chromium\";v=\"107\", \";Not A Brand\";v=\"99\"",
"Sec-Ch-Ua-Mobile": "?0",
"Sec-Ch-Ua-Platform": "\"Windows\"",
"Sec-Fetch-Dest": "document",
"Sec-Fetch-Mode": "navigate",
"Sec-Fetch-Site": "none",
"Sec-Fetch-User": "?1",
"Upgrade-Insecure-Requests": "1",
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/ Safari/537.36",
"X-Amzn-Trace-Id": "Root=1-63963404-57e4efe21185436d73ea000e",
"X-Custom-Header": "value"