Sending Data in aiohttp Requests

Mar 3, 2024 ยท 2 min read

When building web applications and APIs with aiohttp, we often need to send data in our requests to the server. This data allows the client to provide information to the server for processing, storage, or to influence application flow.

There are a few common ways to send data in aiohttp requests:


JSON is a ubiquitous data format in web APIs and aiohttp makes it easy to send. We simply pass a Python dict to the json parameter:

import aiohttp

data = {'key1': 'value1', 'key2': 'value2'}

async with aiohttp.ClientSession() as session:
    async with'', json=data) as response:

The aiohttp request will automatically JSON encode the data and send it with a Content-Type: application/json header.

Form Data

To send form data, the same way an HTML form would send data, we can use the data parameter:

data = {'username': 'john', 'password': '1234'}

async with'', data=data) as response:
   print(await response.text())

The data dict will be form encoded and the correct header will also be added.

File Uploads

aiohttp makes it easy to upload files in requests as well. We use the files parameter:

files = {'upload_file': open('report.pdf', 'rb')}

async with'', files=files) as response:

This will properly handle the file upload including multi-part encoding and random boundary generation.

Custom Headers

We can also add custom headers to requests using the headers parameter:

headers = {'X-Auth-Token': 'secret-token'}
async with session.get('', headers=headers) as response:
    print(await response.json())

This allows adding authentication, content-type, or any other custom headers needed.

Handling Errors

When posting data, errors may occur so its important to handle them properly:

    async with'', json=data) as response:
except aiohttp.ClientResponseError as e:

This makes sure any 4xx or 5xx errors from the server are handled cleanly.

Posting data is essential for most aiohttp based apps and APIs. Using json, form data, file uploads, and custom headers gives the flexibility needed for interacting with third party APIs or building your own. By handling errors and exceptions properly, we can build robust apps and clients.

Browse by tags:

Browse by language:

The easiest way to do Web Scraping

Get HTML from any page with a simple API call. We handle proxy rotation, browser identities, automatic retries, CAPTCHAs, JavaScript rendering, etc automatically for you

Try ProxiesAPI for free

curl ""

<!doctype html>
    <title>Example Domain</title>
    <meta charset="utf-8" />
    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />


Don't leave just yet!

Enter your email below to claim your free API key: