duckduckgo-search

Use the ddgs CLI or Python library, which queries DuckDuckGo for free with no API key. Install it with pip install ddgs, then run commands like ddgs text -q "your query" -m 5 for text results.

Run ddgs followed by a search type: text, news, images, or videos. Pass the query with -q, max results with -m, and optionally region with -r, time limit with -t, or JSON output with -o json.

The max_results parameter is keyword-only in the ddgs library, so ddgs.text("query", 5) fails. Always pass it as ddgs.text("query", max_results=5) to avoid the error.

Terminal and execute_code are separate runtimes, so installing ddgs in the shell does not make it importable in execute_code. Verify the import in that specific runtime or keep using the CLI instead.

No, ddgs returns only titles, URLs, and snippets, not full page content. Search first to find relevant URLs, then extract the best one with web_extract, browser tools, or curl.

DuckDuckGo may rate-limit rapid requests, block some cloud IPs, and return variable fields between results. Add short delays between searches, use .get() for optional fields, and retry with adjusted queries if results come back empty.