Skip to main content

Library for querying the instant answer API of DuckDuckGo search engine.

Project description

PyPI package CI Status Coverage

DuckDuckPy is a Python library for querying DuckDuckGo API and render results either to Python dictionary or namedtuple.


  • Uses standard library only
  • Works on Python 2.6+ and 3.3+
  • Unit test coverage 100%
  • SSL and unicode support
  • Licensed under MIT license


You can install DuckDuckPy either via the Python Package Index (PyPI) or from source.

To install using pip:

$ pip install duckduckpy

To install using easy_install:

$ easy_install duckduckpy

To install from sources you can download the latest version of DuckDuckPy either from PyPI or GitHub, extract archive contents and run following command from the source directory:

$ python install

Latest upstream version can be installed directly from the git repository:

$ pip install git+

API description

query(query_string, secure=False, container=u'namedtuple', verbose=False,
      user_agent=u'duckduckpy 0.2', no_redirect=False, no_html=False,

Generates and sends a query to DuckDuckGo API.


query_string Query to be passed to DuckDuckGo API.
secure Use secure SSL/TLS connection. Default - False. Syntactic sugar is secure_query function which is passed the same parameters.
container Indicates how dict-like objects are serialized. There are two possible options: namedtuple and dict. If ‘namedtuple’ is passed the objects will be serialized to namedtuple instance of certain class. If ‘dict’ is passed the objects won’t be deserialized. Default value: ‘namedtuple’.
verbose Don’t raise any exception if error occurs. Default value: False.
user_agent User-Agent header of HTTP requests to DuckDuckGo API. Default value: ‘duckduckpy 0.2’
no_redirect Skip HTTP redirects (for !bang commands). Default value: False.
no_html Remove HTML from text, e.g. bold and italics. Default value: False.
skip_disambig Skip disambiguation (D) Type. Default value: False.


DuckDuckDeserializeError JSON serialization failed.
DuckDuckConnectionError Something went wrong with httplib operation.
DuckDuckArgumentError Passed argument is wrong.


Container depends on container parameter. Each field in the response is converted to the so-called snake case.


>>> from duckduckpy import query
>>> response = query('Python') # namedtuple is used as a container
>>> response
Response(redirect=u'', definition=u'', image_width=0, ...}
>>> type(response)
<class 'duckduckpy.api.Response'>
>>> response.related_topics[0]
Result(first_url=u'', text=...)
>>> type(response.related_topics[0])
<class 'duckduckpy.api.Result'>

>>> response = query('Python', container='dict') # dict as the container
>>> type(response)
<type 'dict'>
>>> response
{u'abstract': u'', u'results': [], u'image_is_logo': 0, ...}
>>> type(response['related_topics'][0])
<type 'dict'>
>>> response['related_topics'][0]
{u'first_url': u'', u'text': ...}


  • SSL certificate checking

Project details

Release history Release notifications

This version
History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
duckduckpy-0.2.tar.bz2 (7.1 kB) Copy SHA256 hash SHA256 Source None Nov 21, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page