DuckDunk

Searching the web should be easy. DuckDunk provides dead simple DuckDuckGo querying for webpages and images.

Installation

Easily install with pip through PyPI:

pip install duckdunk

Usage

Using site search results:

import duckdunk

# Searches with DuckDuckGo and returns the result list
results = duckdunk.web_search('cat facts')
# Obtain information such as the URL, title, and snippet from each result:
print(results[0].title)
print(results[0].url)
# If you just want to downlaod the page text:
print(results[0].text())

Using image search results:

import duckdunk

# Obtain images with metadata (title, source, thumbnail, original image, etc)
results = duckdunk.image_search('cat')
# Quickly view one of the results
img = results[0].download()
img.show()

About

There are a LOT of DuckDuckGo search packages for Python. However, they either lack support for features, or focus on a specific use case. Moreover, most of these packages are very old and outdated. The goal of this project is to bring a complete set of web search tools to Python, currently through the use of the DuckDuckGo search engine. Right now the aim is to support most essential DuckDuckGo features through a human-friendly library.

A word of warning

Requests are purposely delayed. Sending many simultaneous requests to DuckDuckGo will almost always fail. Too many of these problematic requests, and DuckDuckGo will temporarily block the client.

If you don't plan to make many requests, this delay can be removed: duckdunk.web_search('cat facts', delay=0)

The downloads for image previews from Bing could probably be threaded safely, but for the time being they are downloaded one at a time.

Download files

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

Source Distribution

duckdunk-0.12.0.tar.gz (6.5 kB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

duckdunk-0.12.0-py3-none-any.whl (7.2 kB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file duckdunk-0.12.0.tar.gz.

File metadata

Download URL: duckdunk-0.12.0.tar.gz
Upload date: Aug 22, 2026
Size: 6.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for duckdunk-0.12.0.tar.gz
Algorithm	Hash digest
SHA256	`f8279ffb722e4788b369d123df34b24bed101f5416396d780947b497e8f0be16`
MD5	`6ba73b3f948dc584d338a6cd25e45bdd`
BLAKE2b-256	`231753d9611ffc7a9f8851e9d4ff70160dcdc2fbc0e899037c5e5d10278ebc66`

See more details on using hashes here.

Provenance

The following attestation bundles were made for duckdunk-0.12.0.tar.gz:

Publisher: python-publish.yml on Jumiranger/DuckDunk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: duckdunk-0.12.0.tar.gz
- Subject digest: f8279ffb722e4788b369d123df34b24bed101f5416396d780947b497e8f0be16
- Sigstore transparency entry: 2557305792
- Sigstore integration time: Aug 22, 2026
Source repository:
- Permalink: Jumiranger/DuckDunk@93295b4f5f9b86b1206382bc029898eb06f9642e
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Jumiranger
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@93295b4f5f9b86b1206382bc029898eb06f9642e
- Trigger Event: workflow_dispatch