Python Requests post() Method

Example

Make a POST request to a web page, and return the response text:

import requests

url = 'https://www.w3schools.com/python/demopage.php'
myobj = {'somekey': 'somevalue'}

x = requests.post(url, json = myobj)

print(x.text)

Run Example »

Definition and Usage

The post() method sends a POST request to the specified url.

The post() method is used when you want to send some data to the server.

Syntax

requests.post(url, data={key: value}, json={key: value}, args)

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

requests.post(url, data = myobj, timeout=2.50)

Parameter Values

Parameter		Description
url	Try it	Required. The url of the request
data	Try it	Optional. A dictionary, list of tuples, bytes or a file object to send to the specified url
json	Try it	Optional. A JSON object to send to the specified url
files	Try it	Optional. A dictionary of files to send to the specified url
allow_redirects	Try it	Optional. A Boolean to enable/disable redirection. Default `True` (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 Try it	Optional. A Boolean or a String indication to verify the servers TLS certificate or not. Default `True`

Return Value

A requests.Response object.

❮ Requests Module