DDGS is a Python metasearch library that aggregates results from multiple backends via an API, CLI, and servers. It exposes text, images, videos, news, and books search alongside extraction utilities and MCP/API server support.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
DDGS is a metasearch library that aggregates results from diverse web search services. It provides programmatic interfaces to perform text, images, videos, news, and books searches, as well as content extraction from URLs. It includes API server and MCP server support for distributed usage.
How it works
The project exposes a DDGS class with lazy loading. It supports multiple backends (e.g., for text: bing, brave, duckduckgo, google, etc.). Each search function (text, images, videos, news, books) accepts backend, region, safesearch, timelimit, max_results, page, and other backend-specific filters. An extract() function fetches a URL and returns content in formats such as text_markdown, text_plain, text_rich, text, or content (bytes).
Getting started
Install the base package and optional servers:
pip install -U ddgs # Base install
pip install -U ddgs[api] # API server (FastAPI)
pip install -U ddgs[mcp] # MCP server (stdio)
CLI usage is shown as:
ddgs api # Start server in foreground
MCP client configuration and endpoints are documented in the README, including how to start the MCP server and available tools.
Recent releases
Latest release: v9.14.4 (2026-05-15) – fix(engines): update DuckDuckgo by @deedy5. Full changelog indicates incremental engine and feature updates across v9.14.x series. The full changelog is available at the repository compare pages.
Traction
Stars: 2865. Forks: 269. Open issues: 23. Created: 2021-04-25. Last push: 2026-05-23.
Behind the repo
DDGS is maintained under the MIT license and targets Python (≥3.10). It lists topics including api, ddgs, dht, mcp, metasearch, p2p, python, search, websearch.
Caveats
License: MIT. Age: project created 2021-04-25. Development activity shown by last_push 2026-05-23. Open issues: 23. No explicit caveats beyond package and endpoint usage details in the README.






