duckduckgo-search

What's Changed

• Fix images ratelimit by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/310

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v8.0.3...v8.0.4

What's Changed

• Remove http2_only Client parameter by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/308

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v8.0.2...v8.0.3

What's Changed

• fix(DDGS.text): update headers by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/305

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v8.0.1...v8.0.2

• refactor: remove dead code
• refactor: remove dead code
• refactor: bump to primp=0.15.0

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v8.0.0...v8.0.1

Chat moved to duckai package.

• feat(chat): remove chat
• fix(typing): fix typing in cli and tests

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.5.5...v8.0.0

• fix(chat): add _chat_xfe

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.5.4...v7.5.5

• fix(chat): x-vqd-hash-1 = ""

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.5.3...v7.5.4

What's Changed

• DDGS.chat: bugfix by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/294

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.5.2...v7.5.3

fix(temp): don't set Client.headers

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.5.1...v7.5.2

What's Changed

• Bugfix DDGS.text() payload by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/291

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.5.0...v7.5.1

• chore: bump primp to v0.14.0
• tests: sleep 2 seconds between tests
• feat(chat): add mistral-small-3
• feat(chat): stream response
• feat(cli chat): stream response

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.3.2...v7.5.0

What's Changed

• Chat: bugfix ConversationLimitException by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/288

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.4.4...v7.4.5

What's Changed

• DDGS.chat: add mistral-small-3 by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/285
• fix(patch): patch only while sending request

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.4.3...v7.4.4

• feat: patch httpcore
• feat: improve ssl_context

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.4.2...v7.4.3

What's Changed

• Use httpx for requests by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/282
• Cli(chat): stream answer, add DDGS.chat_yield (response message generator) by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/283

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.3.2...v7.4.2

What's Changed

• DDGS.chat: add llama-3.3-70b model by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/281

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.3.1...v7.3.2

What's Changed

• DDGS.chat: add o3-mini model by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/280

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.3.0...v7.3.1

What's Changed

• clarify exceptions in README by @vpoulailleau in https://github.com/deedy5/duckduckgo_search/pull/275
• Drop Support for Python 3.8 by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/276
• Bump primp to v0.11.0
• Add _impersonates_os

New Contributors

• @vpoulailleau made their first contribution in https://github.com/deedy5/duckduckgo_search/pull/275

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.2.1...v7.3.0

• Bump primp to v0.10.0
• DDGS._impersonates: add "firefox_128"

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.2.0...v7.2.1

• Bump primp to v0.9.3
• DDGS._impersonates: add "firefox_117"
• Remove backend="ecosia"

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.1.1...v7.2.0

• DDGS.text: deprecate backend='api'

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.1.0...v7.1.1

• add backend="ecosia"
• DDGS._impersonates: delete okhttp*
• DDGS.text: reduce pagination

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.0.2...v7.1.0

• Bump primp to v0.9.2
• DDGS._impersonates: update

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v7.0.1...v7.0.2

What's Changed

• [simplify]: remove AsyncDDGS, remove answers, maps, suggestions, translate; [text]: remove multithreading by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/268
• [DDGS.text]: add backend="auto", [DDGS.images|news|videos]: remove multithreading by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/269

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.4.2...v7.0.1

• use env var DDGS_PROXY
• utils: _text_extract_json() bugfix
• Bump primp to v0.9.1, update dependencies
• DDGS._impersonates: add "safari_ios_18.1.1", "safari_18.2", "edge_131"

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.7...v6.4.2

• added armv7 compatibility: Bump primp to v0.8.1

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.6...v6.3.7

• Bump primp version to v0.8.0
• DDGS._impersonates: add "chrome_131"
• CLI: _download_file: impersonate="chrome_131"
• CLI: --max_results=None by default; remove default=None

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.5...v6.3.6

What's Changed

• CLI: 1)-dd to specify custom download directory, 2) -o can now set full filename by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/263
• CLI: text() max_results=10 default
• text(): update pagination logic (0, 10, 25, 40, ...)
• text(): max(max_results)=190
• videos(): max(max_results)=200
• tests: text() max_results=20
• README: update examples, remove httpx version info

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.4...v6.3.5

• CI: test python 3.9 , 3.13
• CLI: images license parameter - add ShareCommercially
• CLI: _download_file: impersonate="chrome_130"

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.3...v6.3.4

• Bump primp version to >=0.6.5
• DDGS._impersonates: add "chrome_130"
• CI: test python 3.9 , 3.13

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.2...v6.3.3

What's Changed

• Add verify parameter to skip SSL verification when making the requests by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/258

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.1...v6.3.2

• DDGS._impersonates: updated
• primp.Client: verify=True
• primp: bump version to v0.6.4

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.3.0...v6.3.1

What's Changed

• DDGS._get_vqd(): use "GET" request by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/255
• update tests
• cli._download_file(): use impersonate="chrome_129"

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.13...v6.3.0

• Bump primp to v0.6.3
• DDGS._impersonates: add chrome_129, safari_18, safari_ipad_18
• README: proxy section - change socks5:// to socks5h://

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.12...v6.2.13

• [utils] bugfix _normalize_url() - replace space after unquote
• README: update install section (bump version with httpx to v6.2.11b1)
• Update requrements: bump primp to v0.6.2
• DDGS._impersonates: add chrome_128
• CLI: _download_file - set impersonate=chrome_128

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.10...v6.2.12

• [utils] bugfix _normalize_url() - replace space after unquote

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.8b1...v6.2.11b1

• Bump primp to 0.6.1

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.9...v6.2.10

• Bump primp version to >=0.6.0
• DDGS._impersonates: add "safari_17.0"
• [README] add httpx release info (v6.2.8b1)

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.8...v6.2.9

What's Changed

• add timeout parameter to achat() by @arabianq in https://github.com/deedy5/duckduckgo_search/pull/243
• Change type-annotations to the python3.10+ style by using the annotations future import by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/245
• DDGS._impersonates: remove "edge_99"
• [pyproject.toml]: classifiers - add python 3.13
• update requirements

New Contributors

• @arabianq made their first contribution in https://github.com/deedy5/duckduckgo_search/pull/243

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.7...v6.2.8

Special version with HTTPX

• use httpx for requests

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.8...v6.2.8b1

• chat: update "llama-3-70b" to "llama-3.1-70b"

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.6...v6.2.7

What's Changed

• Changing the gpt-3.5 model to gpt-4o-mini by @mrgick in https://github.com/deedy5/duckduckgo_search/pull/242
• chat(): increase the default timeout from 20 to 30 seconds

New Contributors

• @mrgick made their first contribution in https://github.com/deedy5/duckduckgo_search/pull/242

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.5...v6.2.6

• bump primp to v0.5.5 - Update requirements
• impersonate: add chrome_127
• add def _expand_proxy_tb_alias(): expand "tb" alias to full url
• CLI: chat() - 1) default model gpt-3.5, 2) remove bg="black" in AI answers

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.4...v6.2.5

• rename pyreqwest_impersonate to primp
• impersonate: add edge_127, remove chrome_99
• CLI: chat - save|load tokens count to|from json cache

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.3...v6.2.4

• chat(): bugfix token counting, rename _chat_conversation_size to _chat_tokens_count

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.2...v6.2.3

• Bump pyreqwest_impersonate to v0.5.3, update requirements
• Improve chat:
  1. handle exceptions, add ConversationLimitException,
  2. add _chat_conversation_size (show in CLI as contextsize)

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.1...v6.2.2

• DDGS._impersonates: add "safari_17.5"
• _text_html(), _text_lite(): bugfix IndexError
• DDGS._text_lite(): strip() body

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.2.0...v6.2.1

• Update requirements - bump pyreqwest_impersonate to v0.5.0
• chat: small improvement

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.12...v6.2.0

What's Changed

• chat(): bugfix (remove superfluous backslashes) by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/238

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.11...v6.1.12

What's Changed

• Chat improving (parse response message without json.loads, add timeout parameter) by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/235
• Use orjson if installed, json_dumps(): add ensure_ascii=False, indent=2
• DDGS.init(): randomize impersonate
• Update tests
• README: update

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.9...v6.1.11

• Remove orjson from dependencies (tests show that the embedded json module is faster)

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.8...v6.1.9

• CLI: chat() - rename save to load, remove click.wrap_text()
• CLI: use proxy param -p tb as an alias for socks5://127.0.0.1:9150
• README: update + add example results
• Update requirements

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.7...v6.1.8

• CLI: chat(): add multiline and model options
• update requirements
• chat(): use list comprehension to extract messages
• impersonate="chrome_126"

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.6...v6.1.7

What's Changed

• chat(): add models "llama-3-70b" add "mixtral-8x7b" by @deedy5 in https://github.com/deedy5/duckduckgo_search/pull/226
• update requirements

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.5...v6.1.6

• text(): bugfix region parameter

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.4...v6.1.5

• text(): max_results cutoff 2000
• news(): max_results cutoff 120

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.3...v6.1.4

• Bump pyreqwest_impersonate to v0.4.7

Full Changelog: https://github.com/deedy5/duckduckgo_search/compare/v6.1.2...v6.1.3