python requests post url form-encoded

Python Requests POST URL Form-Encoded

When working with APIs or web-based services, sending data to a server is a common task. One way to do this is using the HTTP POST method along with form-encoded data. Python's Requests library provides an easy way to achieve this.

Using Requests to Send POST Requests with Form-Encoded Data

The Requests library provides a simple and elegant way to send HTTP requests in Python. Here's an example of using Requests to send a POST request with form-encoded data:

import requests

url = ''
data = {'name': 'John Doe', 'email': '[email protected]'}

response =, data=data)


In this example, we first import the Requests library. We then define the URL we want to send the POST request to and the data we want to include in the request. The data is a dictionary with keys representing form field names and values representing the corresponding values of those fields.

We then use the method to send the POST request to the specified URL, passing in the URL and the data dictionary as parameters. The post() method returns a Response object.

Finally, we print the response text, which will contain the server's response to our request.

Handling Responses

The response object returned by the post() method provides several useful attributes and methods for working with the server's response:

  • response.status_code: The HTTP status code returned by the server
  • response.text: The response text returned by the server, which may be in JSON, XML or plain text format
  • response.json(): A method that parses the response text as JSON and returns it as a Python object
  • response.headers: A dictionary containing the HTTP headers returned by the server

Here's an example of how to use these attributes and methods:

import requests

url = ''
data = {'name': 'John Doe', 'email': '[email protected]'}

response =, data=data)

if response.status_code == 200:
    print('Request successful')
    print('Request failed with status code:', response.status_code)

In this example, we first send the POST request to the server as before. We then check the response status code to see if the request was successful. If it was, we print the JSON response returned by the server. If it wasn't, we print an error message along with the status code.


Using Python's Requests library to send POST requests with form-encoded data is a simple and effective way to interact with web-based services and APIs. By understanding the basics of how to use Requests, you can easily send and receive data from servers in your Python applications.