skip to navigation
skip to content

duckduckgo2 0.21

Library for querying the DuckDuckGo API

Latest Version: 0.242

A Python library for querying the DuckDuckGo API.

Copyright Michael Stephens <>, released under a BSD-style license.

Source: Original source: (outdated)

This version has been forked from the original to handle some new features of the API, and switch from XML to JSON.


To install run

python install


>>> import duckduckgo
>>> r = duckduckgo.query('DuckDuckGo')
>>> r.type
>>> r.results[0].text
u'Official site'
>>> r.results[0].url
>>> r.abstract.url
>>> r.abstract.source
>>> r = duckduckgo.query('Python')
>>> r.type
>>> r.related[1].text
u'Python (programming language), a computer programming language'
>>> r.related[1].url
>>> r.related[7].topics[0].text # weird, but this is how the DDG API is currently organized
u'Armstrong Siddeley Python, an early turboprop engine'
>>> r = duckduckgo.query('1 + 1')
>>> r.type
>>> r.answer.text
u'1 + 1 = 2'
>>> r.answer.type
>>> print duckduckgo.query('19301', kad='es_ES').answer.text
19301 es un código postal de Paoli, PA
>>> print duckduckgo.query('how to spell test', html=True).answer.text
<b>Test</b> appears to be spelled right!<br/><i>Suggestions: </i>test, testy, teat, tests, rest, yest.
Special keyword args for query():
  • useragent - string, The useragent used to make API calls. This is somewhat irrelevant, as they are not logged or used on DuckDuckGo, but it is retained for backwards compatibility.
  • safesearch - boolean, enable or disable safesearch.
  • html - boolean, Allow HTML in responses?
File Type Py Version Uploaded on Size
duckduckgo2-0.21.tar.gz (md5) Source 2012-08-16 4KB
  • Downloads (All Versions):
  • 29 downloads in the last day
  • 202 downloads in the last week
  • 798 downloads in the last month