Random User Agent

1.0.1 · abandoned · verified Wed Apr 15

This Python library provides lists of user agents based on filters such as operating system, software name, and popularity. It currently holds a collection of over 326,000 user agents. The library's last release was version 1.0.1 in December 2018, making its user agent data significantly outdated for modern web scraping and automation tasks.

Warnings

breaking The library has not been updated since December 2018. As user agent strings evolve rapidly with new browser and OS versions, the data provided by this library is severely outdated. Using these old user agents in modern web scraping or automation tasks is highly likely to lead to detection or incorrect rendering.
Fix: Consider using actively maintained libraries like 'fake-useragent' or 'ua-generator' that provide up-to-date user agent lists or dynamically generate them. Always verify the recency of user agent data if using any random user agent generator.
gotcha The project is no longer actively maintained, with the last commit dating back to 2018. This means there will be no bug fixes, feature updates, or updates to its internal user agent database, which is crucial for the utility of such a library.
Fix: Assess the critical need for up-to-date user agents. If your application relies on current browser and OS identities, this library is unsuitable. Migrate to a well-maintained alternative.

Install

pip install random_user_agent Install stable version

Imports

UserAgent

from random_user_agent.user_agent import UserAgent

SoftwareName, OperatingSystem

from random_user_agent.params import SoftwareName, OperatingSystem

Quickstart

This quickstart demonstrates how to import the UserAgent class and parameter enums, initialize a user agent rotator with specific browser and operating system filters, retrieve a list of user agents, and get a single random user agent.

from random_user_agent.user_agent import UserAgent
from random_user_agent.params import SoftwareName, OperatingSystem

# Define desired filters
software_names = [SoftwareName.CHROME.value, SoftwareName.FIREFOX.value]
operating_systems = [OperatingSystem.WINDOWS.value, OperatingSystem.LINUX.value]

# Initialize the UserAgent rotator with filters and a limit
user_agent_rotator = UserAgent(
    software_names=software_names,
    operating_systems=operating_systems,
    limit=10 # Get 10 random user agents
)

# Get a list of user agents
user_agents = user_agent_rotator.get_user_agents()

# Print some user agents
for i, ua in enumerate(user_agents[:3]):
    print(f"User Agent {i+1}: {ua}")

# Get a single random user agent
single_ua = user_agent_rotator.get_random_user_agent()
print(f"\nSingle Random User Agent: {single_ua}")

view raw JSON →