A simple module for searching on DuckDuckGo
A simple Python module for searching on DuckDuckGo.
Duckpy can be installed using pip with this command
pip install -U duckpy
Alternatively, you can install the most recent version from git
pip install -U git+https://github.com/AmanoTeam/duckpy
If you are using Debian or Ubuntu, you can install with this command (Currently only in Debian Unstable and Ubuntu 20.10+)
sudo apt install python3-duckpy
from duckpy import Client client = Client() results = client.search("Python Wikipedia") # Prints first result title print(results.title) # Prints first result URL print(results.url) # Prints first result description print(results.description)
We also provide an asynchronous version inside the
import asyncio from duckpy import AsyncClient client = AsyncClient() async def get_results(): results = await client.search("Python Wikipedia") # Prints first result title print(results.title) # Prints first result URL print(results.url) # Prints first result description print(results.description) loop = asyncio.get_event_loop() loop.run_until_complete(get_results())
Python (programming language) - Wikipedia https://en.wikipedia.org/wiki/Python_(programming_language) Python is an interpreted, high-level, general-purpose programming language. Created by Guido van Rossum and first released in 1991...
You can also set up proxies or set up custom User-Agent strings depending on your needs.
Setting up proxies
DuckDuckGo may temporarily block your request IP or return empty results, especially if you are using the library for scraping, bots and other stuff that generate many requests. This is not a duckpy issue and can be prevented using proxies.
You can pass a list with proxies in the Client object, then duckpy will use these proxies to make requests:
import duckpy client = duckpy.Client(proxies=['http://22.214.171.124:80', 'https://126.96.36.199:443'])
If you pass more than one proxy, they will be randomly chosen every time you use the .search() method.
Setting up custom User-Agents
import duckpy user_agents = [ "Mozilla/5.0 (X11; Linux x86_64; rv:79.0) Gecko/20100101 Firefox/79.0", "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.105 Safari/537.36" ] client = duckpy.Client(default_user_agents=user_agents)
Again, if you pass more than one User-Agent, they will be randomly chosen every time you use the .search() method.
We are not affiliated, associated, authorized, endorsed by, or in any way officially connected with DuckDuckGo, or any of its subsidiaries or its affiliates. The official DuckDuckGo website can be found at https://duckduckgo.com.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.