ivankliuk / duckduckpy

DuckDuckGo search engine API library for Python

DuckDuckPy

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

Features

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

Installation

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 setup.py install

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

$ pip install git+https://github.com/ivankliuk/duckduckpy.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,
      skip_disambig=False)

Generates and sends a query to DuckDuckGo API.

Arguments:

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.
lang	Override "us-en" language & region. Default - None.

Raises:

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

Returns:

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

Usage

>>> 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'https://duckduckgo.com/Python', 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'https://duckduckgo.com/Python', u'text': ...}

duckduckpy's Issues

how to get more results?

hi thanks for working ,but i want use ddg to search for more than 10 pages results, how to do that? do you know about the parms "s","dc" and "vdp"?

Does this support searching on a particular site?

e.g. https://help.duckduckgo.com/duckduckgo-help-pages/results/syntax/ says site: would work.

https://duckduckgo.com/?q=bill+gates+site%3Amicrosoft.com&t=h_&ia=web works via the web but I can't get results via API the equivalent using query()

Pls provide a simple command line invocation script for easy testing.

Something like

import sys, getopt
from duckduckpy import query;

def main(argv):
   query_string = sys.argv[1];
   print ("query: ", query_string);
   response = query(query_string);
   print(response);

if __name__ == "__main__":
   main(sys.argv[1:])

No results

I tried this code:

from duckduckpy import query
response = query('python')
print(response.results)

All I get is an empty list.