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 to be passed to DuckDuckGo API.


Use secure SSL/TLS connection. Default - False. Syntactic sugar is secure_query function which is passed the same parameters.


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’.


Don’t raise any exception if error occurs. Default value: False.


User-Agent header of HTTP requests to DuckDuckGo API. Default value: ‘duckduckpy 0.2’


Skip HTTP redirects (for !bang commands). Default value: False.


Remove HTML from text, e.g. bold and italics. Default value: False.


Skip disambiguation (D) Type. Default value: False.



JSON serialization failed.


Something went wrong with httplib operation.


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

Download files

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

Source Distribution

duckduckpy-0.2.tar.bz2 (7.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page