Integrating Oxylabs’ Residential Proxies with AIOHTTP

Requirements for the Integration

For the integration to work you’ll need to install aiohttp library, use Python 3.6 version or higher and Residential Proxies.
If you don’t have aiohttp library, you can install it by using pip command:

pip install aiohttp

You can get Residential Proxies here:

Proxy Authentication

There are 2 ways to authenticate proxies with aiohttp.
The first way is to authorize and pass credentials along with the proxy URL using aiohttp.BasicAuth:

USER = "user"
PASSWORD = "pass"
async def fetch():
    async with aiohttp.ClientSession() as session:
        proxy_auth = aiohttp.BasicAuth(USER, PASS)
        async with session.get("", 
        ) as resp:
            print(await resp.text())

The second one is by passing authentication credentials in proxy URL:

USER = "user"
PASSWORD = "pass"

async def fetch():
    async with aiohttp.ClientSession() as session:
        async with session.get("", 
        ) as resp: 
            print(await resp.text())

In order to use your own proxies, adjust user and pass fields with your Oxylabs account credentials.

Testing Proxies

To see if the proxy is working, try visiting
If everything is working correctly, it will return an IP address of a proxy that you’re currently using.

Sample Project: Extracting Data From Multiple Pages

To better understand how residential proxies can be utilized for asynchronous data extracting operations, we wrote a sample project to scrape product listing data and save the output to a CSV file. The proxy rotation allows us to send multiple requests at once risk-free – meaning that we don’t need to worry about CAPTCHA or getting blocked. This makes the web scraping process extremely fast and efficient – now you can extract data from thousands of products in a matter of seconds!

import asyncio
import time
import sys
import os

from bs4 import BeautifulSoup
import pandas as pd
import aiohttp

USER = "user"
PASSWORD = "pass"

# Generate a list of URLs to scrape
url_list = [
for page_num 
in range(1, 51)

async def fetch(session, sem, url):
    async with sem:
        async with session.get(url, 
        ) as response:
            await parse_url(await response.text())

async def parse_url(text):
    soup = BeautifulSoup(text, "lxml")
    for product_data in"ol.row > li > article.product_pod"):
        data = {
            "title": product_data.select_one("h3 > a")["title"],
            "url": product_data.select_one("h3 > a").get("href")[5:],
            "product_price": product_data.select_one("p.price_color").text,
            "stars": product_data.select_one("p")["class"][1],
        print(f"Grabing book: {data['title']}")
async def create_jobs():
    final_res = []
    sem = asyncio.Semaphore(4)
    async with aiohttp.ClientSession() as session:
        await asyncio.gather(*[fetch(session, sem, url) 
        for url in url_list
if __name__ == "__main__":
    final_list = []
    start = time.perf_counter()
    # Different Event Loop Policy must be loaded if you're using Windows OS 
    # This helps to avoid "Event Loop is closed" error
    if sys.platform.startswith("win") and sys.version_info.minor >= 8:
    except Exception: 
        print("We broke, but there might still be some results")
    print(f"\nTotal of {len(final_list)} products gathered in {time.perf_counter() - start:.2f} seconds")
    df = pd.DataFrame(final_list)
    df["url"] = df["url"].map(lambda x: ''.join(["", x]))
    filename = "scraped-books.csv"
    df.to_csv(filename, encoding='utf-8-sig', index=False)
    print(f"\nExtracted data can be found at {os.path.join(os.getcwd(), filename)}")

If you want to test the project’s script by yourself, you’ll need to install some additional packages. To do that, simply download requirements.txt file and use pip command:

pip install -r requirements.txt

If you’re having any trouble integrating proxies with aiohttp and this guide didn’t help you – feel free to contact Oxylabs customer support at [email protected].