Python Requests head() Method

Make a HEAD request to a web page, and return the HTTP headers:

import requests

x = requests.head('https://www.w3schools.com/python/demopage.php')

print(x.headers)

Definition and Usage

The head() method sends a HEAD request to the specified url.

HEAD requests are done when you do not need the content of the file, but only the status_code or HTTP headers.

requests.head(url, args)

args means zero or more of the named arguments in the parameter table below. Example:

requests.head(url, timeout=2.50)

Parameter		Description
url	Try it	Required. The url of the request
allow_redirects	Try it Try it	Optional. A Boolean to enable/disable redirection. Default `False` (not allowing redirects)
auth	Try it	Optional. A tuple to enable a certain HTTP authentication. Default `None`
cert	Try it	Optional. A String or Tuple specifying a cert file or key. Default `None`
cookies	Try it	Optional. A dictionary of cookies to send to the specified url. Default `None`
headers	Try it	Optional. A dictionary of HTTP headers to send to the specified url. Default `None`
proxies	Try it	Optional. A dictionary of the protocol to the proxy url. Default `None`
stream	Try it	Optional. A Boolean indication if the response should be immediately downloaded (False) or streamed (True). Default `False`
timeout	Try it	Optional. A number, or a tuple, indicating how many seconds to wait for the client to make a connection and/or send a response. Default `None` which means the request will continue until the connection is closed
verify	Try it	Optional. A Boolean or a String indication to verify the servers TLS certificate or not. Default `True`

The head() method returns a requests.Response object.