Skip to main content

Up to date simple useragent faker with real world database

Project description


Up to date simple useragent faker with real world database



pip install fake-useragent


from fake_useragent import UserAgent
ua = UserAgent()
# Mozilla/5.0 (Windows; U; MSIE 9.0; Windows NT 9.0; en-US);
# Mozilla/5.0 (compatible; MSIE 10.0; Macintosh; Intel Mac OS X 10_7_3; Trident/6.0)'
ua['Internet Explorer']
# Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 6.1; Trident/4.0; GTB7.4; InfoPath.2; SV1; .NET CLR 3.3.69573; WOW64; en-US)
# Opera/9.80 (X11; Linux i686; U; ru) Presto/2.8.131 Version/11.11
# Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.2 (KHTML, like Gecko) Chrome/22.0.1216.0 Safari/537.2'
# Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/537.13 (KHTML, like Gecko) Chrome/24.0.1290.1 Safari/537.13
ua['google chrome']
# Mozilla/5.0 (X11; CrOS i686 2268.111.0) AppleWebKit/536.11 (KHTML, like Gecko) Chrome/20.0.1132.57 Safari/536.11
# Mozilla/5.0 (Windows NT 6.2; Win64; x64; rv:16.0.1) Gecko/20121011 Firefox/16.0.1
# Mozilla/5.0 (X11; Ubuntu; Linux i686; rv:15.0) Gecko/20100101 Firefox/15.0.1
# Mozilla/5.0 (iPad; CPU OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5355d Safari/8536.25

# and the best one, random via real world browser usage statistic


fake-useragent store collected data at your os temp dir, like /tmp

If You want to update saved database just:

from fake_useragent import UserAgent
ua = UserAgent()

If You don’t want cache database or no writable file system:

from fake_useragent import UserAgent
ua = UserAgent(cache=False)

Sometimes, or changes their html, or down, in such case fake-useragent uses hosted cache server fallback

If You don’t want to use hosted cache server (version 0.1.5 added)

from fake_useragent import UserAgent
ua = UserAgent(use_cache_server=False)

In very rare case, if hosted cache server and sources will be unavailable fake-useragent wont be able to download data: (version 0.1.3 added)

from fake_useragent import UserAgent
ua = UserAgent()

# Traceback (most recent call last):
#   ...
# fake_useragent.errors.FakeUserAgentError

# You can catch it via

from fake_useragent import FakeUserAgentError

    ua = UserAgent()
except FakeUserAgentError:

If You will try to get unknown browser: (version 0.1.3 changed)

from fake_useragent import UserAgent
ua = UserAgent()
# Traceback (most recent call last):
#   ...
# fake_useragent.errors.FakeUserAgentError

You can completely disable ANY annoying exception with adding fallback: (version 0.1.4 added)

import fake_useragent

ua = fake_useragent.UserAgent(fallback='Your favorite Browser')
# in case if something went wrong, one more time it is REALLY!!! rare case
ua.random == 'Your favorite Browser'

Want to control location of data file? (version 0.1.4 added)

import fake_useragent

# I am STRONGLY!!! recommend to use version suffix
location = '/home/user/fake_useragent%s.json' % fake_useragent.VERSION

ua = fake_useragent.UserAgent(path=location)

If you need to safe some attributes from overriding them in UserAgent by __getattr__ method use safe_attrs you can pass there attributes names. At least this will prevent you from raising FakeUserAgentError when attribute not found.

For example, when using fake_useragent with injections you need to:

import fake_useragent

ua = fake_useragent.UserAgent(safe_attrs=('__injections__',))

Please, do not use if you don’t understand why you need this. This is magic for rarely extreme case.

Experiencing issues???

Make sure that You using latest version!!!

pip install -U fake-useragent

Check version via python console: (version 0.1.4 added)

import fake_useragent


And You are always welcome to post issues

Please do not forget mention version that You are using


pip install tox


  • 0.1.7 April 2, 2017
    • fix broken README.rst

  • 0.1.6 April 2, 2017
    • fixes bug use_cache_server do not affected anything

    • moved to https

    • verify_ssl options added, by default it is True (urllib.urlopen ssl context for Python 2.7.9- and 3.4.3- is not supported)

  • 0.1.5 February 28, 2017
    • added ua.edge alias to Internet Explorer

    • starts displaying Edge statistic

    • Python 2.6 is not tested anymore

    • use_cache_server option added

    • Increased fake_useragent.settings.HTTP_TIMEOUT to 5 seconds

  • 0.1.4 December 14, 2016
    • Added custom data file location support

    • Added fallback browser support, in case of unavailable data sources

    • Added alias fake_useragent.FakeUserAgent for fake_useragent.UserAgent

    • Added alias fake_useragent.UserAgentError for fake_useragent.FakeUserAgentError

    • Reduced fake_useragent.settings.HTTP_TIMEOUT to 3 seconds

    • Started migration to new data file format

    • Simplified a lot 4+ years out of date code

    • Better thread/greenlet safety

    • Added verbose logging

    • Added safe_attrs for prevent overriding by __getattr__

  • 0.1.3 November 24, 2016
    • Added hosted data file, when remote services is unavailable

    • Raises fake_useragent.errors.FakeUserAgentError in case when there is not way to download data

    • Raises fake_useragent.errors.FakeUserAgentError instead of None in case of unknown browser

    • Added gevent.sleep support in gevent patched environment when trying to download data

  • X.X.X xxxxxxx xx, xxxx
    • xxxxx ?????


You can visit authors page

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fake-useragent-0.1.7.tar.gz (12.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page