DuckDuckGo API使用指南

笨笨sg

已于 2025-02-17 10:13:57 修改

阅读量3.6k

点赞数 30

文章标签： DuckDuckGo API 使用指南

于 2025-02-16 17:12:20 首次发布

本文链接：https://blog.csdn.net/a131529/article/details/145667129

版权

1 DuckDuckGo API说明

DuckDuckGo API 允许开发者将 DuckDuckGo 的搜索功能集成到自己的应用程序中，与大多数搜索引擎（如Google）API的区别在于：

隐私优先： DuckDuckGo 的核心价值是保护用户隐私，API 调用不会追踪用户行为，也不会收集或存储用户的个人信息（如 IP 地址、搜索历史等）。
无个性化搜索： 搜索结果不会基于用户的历史行为或偏好进行个性化调整，所有用户看到的搜索结果是一致的。
无广告追踪： DuckDuckGo 不会通过 API 返回的搜索结果嵌入广告追踪器。

除了注重隐私之外，DuckDuckGo API是一个完全免费的项目。

DuckDuckGo API:

无需 API 密钥： 目前使用 DuckDuckGo API 无需注册或获取 API 密钥，可以直接调用。

无明确调用限制： 官方没有明确说明调用频率限制，但建议合理使用以避免滥用。

免费使用： 完全免费，无需支付费用。

Google API:

需要 API 密钥： 使用 Google Search API 需要注册 Google Cloud 账号并获取 API 密钥。

调用限制： 有明确的每日调用限额，超出限额需要付费。

付费模式： 免费额度有限，超出部分按调用次数收费。

但是，鱼和熊掌不可兼得，DuckDuckGo API在保证完全免费的基础上，搜索结果质量可能不如 Google 精准，尤其是在需要个性化推荐的场景下。

值得注意的是，DuckDuckGo API 实际上是一个非官方项目，DuckDuckGo 官方并没有提供正式的 API 服务。我们通常提到的 "DuckDuckGo API" 是基于 DuckDuckGo 搜索引擎的非官方接口，通过模拟请求或解析 DuckDuckGo 的搜索结果来实现功能。

2 Github开源项目链接及官网链接

Github链接：deedy5/duckduckgo_search

AI chat and search for text, news, images and videos using the DuckDuckGo.com search engine.

项目声明如下：

This library is not affiliated with DuckDuckGo and is for educational purposes only. It is not intended for commercial use or any purpose that violates DuckDuckGo's Terms of Service. By using this library, you acknowledge that you will not use it in a way that infringes on DuckDuckGo's terms. The official DuckDuckGo website can be found at https://duckduckgo.com.

浏览器官网：DuckDuckGo - 保护你的隐私是我们的首要任务。

3 使用说明

3.1 Step1：安装第三方库

pip install -U duckduckgo_search

3.2 Step2：搜索运算符

搜索运算符是一些特殊的符号或关键词，可以添加到搜索查询中，以过滤或调整搜索结果。它们类似于其他搜索引擎（如 Google）的高级搜索功能，但 DuckDuckGo 的运算符更注重隐私和简洁性。

运算符详解

（1）基础运算符

运算符示例	作用
`cats dogs`	搜索包含 cats 或 dogs 的结果（默认是“或”关系）。
`"cats and dogs"`	搜索包含精确短语 "cats and dogs" 的结果。
`cats -dogs`	搜索包含 cats 但不包含 dogs 的结果（排除 dogs）。
`cats +dogs`	搜索包含 cats 并且 dogs 必须出现的结果（强调 dogs）。

（2）文件类型过滤

运算符示例	作用
`cats filetype:pdf`	搜索关于 cats 的 PDF 文件。支持的文件类型包括：`pdf`, `doc(x)`, `xls(x)`, `ppt(x)`, `html` 等。

（3）网站过滤

运算符示例	作用
`dogs site:example.com`	搜索来自 example.com 网站的关于 dogs 的结果。
`cats -site:example.com`	搜索关于 cats 的结果，但排除来自 example.com 的页面。

（4）标题和 URL 过滤

运算符示例	作用
`intitle:dogs`	搜索标题中包含 dogs 的页面。
`inurl:cats`	搜索 URL 中包含 cats 的页面。

3.3 Step3：DDGS类介绍

DDGS 类是一个用于从 DuckDuckGo 获取搜索结果的 Python 类，来自第三方库（duckduckgo-search）。这个类封装了与 DuckDuckGo 搜索引擎的交互逻辑，使得开发者可以方便地通过代码获取搜索结果。

在初始化 DDGS 类时，可以传递以下参数：

参数名	类型	说明
`headers`	`dict`	自定义 HTTP 请求头，用于模拟浏览器请求。默认值为 `None`。
`proxy`	`str`	代理服务器地址，支持 `http`/`https`/`socks5` 协议。默认值为 `None`。
`timeout`	`int`	HTTP 请求的超时时间（秒）。默认值为 `10`。
`verify`	`bool`	是否启用 SSL 证书验证。默认值为 `True`。

下面是一个demo：

from duckduckgo_search import DDGS

results = DDGS().text("python programming", max_results=5)
print(results)

# 以 JSON 格式打印结果，indent=2 表示缩进 2 个空格
print(json.dumps(results, indent=2))

[{'title': 'Welcome to Python.org', 'href': 'https://www.python.org/', 'body': "Python is a programming language that lets you work quickly and integrate systems more effectively. Learn More. Get Started. Whether you're new to programming or an experienced developer, it's easy to learn and use Python. Start with our Beginner's Guide. Download."}, {'title': 'Python For Beginners', 'href': 'https://www.python.org/about/gettingstarted/', 'body': 'Learn how to get started with Python, a popular and easy-to-use programming language. Find out how to install, edit, and use Python, and explore its libraries, documentation, and community resources.'}, {'title': 'Python Tutorial - W3Schools', 'href': 'https://www.w3schools.com/python/', 'body': 'Python is a popular programming language. Python can be used on a server to create web applications. Start learning Python now » ...'}, {'title': 'Python Tutorial | Learn Python Programming Language', 'href': 'https://www.geeksforgeeks.org/python-programming-language-tutorial/', 'body': 'Python Programming Language - FAQs What is Python? Python is a high-level, general-purpose and very popular programming language which was created by Guido van Rassum and released in 1991. Python programming language (latest Python 3) is being used in web development and Machine Learning, Mathematics and System Scripting.'}, {'title': 'Python (programming language) - Wikipedia', 'href': 'https://en.wikipedia.org/wiki/Python_(programming_language)', 'body': 'Python is a high-level, general-purpose programming language.Its design philosophy emphasizes code readability with the use of significant indentation. [33]Python is dynamically type-checked and garbage-collected.It supports multiple programming paradigms, including structured (particularly procedural), object-oriented and functional programming.It is often described as a "batteries included ...'}]
[
  {
    "title": "Welcome to Python.org",
    "href": "https://www.python.org/",
    "body": "Python is a programming language that lets you work quickly and integrate systems more effectively. Learn More. Get Started. Whether you're new to programming or an experienced developer, it's easy to learn and use Python. Start with our Beginner's Guide. Download."
  },
  {
    "title": "Python For Beginners",
    "href": "https://www.python.org/about/gettingstarted/",
    "body": "Learn how to get started with Python, a popular and easy-to-use programming language. Find out how to install, edit, and use Python, and explore its libraries, documentation, and community resources."
  },
  {
    "title": "Python Tutorial - W3Schools",
    "href": "https://www.w3schools.com/python/",
    "body": "Python is a popular programming language. Python can be used on a server to create web applications. Start learning Python now \u00bb ..."
  },
  {
    "title": "Python Tutorial | Learn Python Programming Language",
    "href": "https://www.geeksforgeeks.org/python-programming-language-tutorial/",
    "body": "Python Programming Language - FAQs What is Python? Python is a high-level, general-purpose and very popular programming language which was created by Guido van Rassum and released in 1991. Python programming language (latest Python 3) is being used in web development and Machine Learning, Mathematics and System Scripting."
  },
  {
    "title": "Python (programming language) - Wikipedia",
    "href": "https://en.wikipedia.org/wiki/Python_(programming_language)",
    "body": "Python is a high-level, general-purpose programming language.Its design philosophy emphasizes code readability with the use of significant indentation. [33]Python is dynamically type-checked and garbage-collected.It supports multiple programming paradigms, including structured (particularly procedural), object-oriented and functional programming.It is often described as a \"batteries included ..."
  }
]

3.4 Step4：代理（Proxy）

1. 为什么使用代理？

隐藏 IP 地址：通过代理服务器发送请求，可以隐藏你的真实 IP 地址。
绕过限制：某些网站可能会根据 IP 地址限制访问，使用代理可以绕过这些限制。
提高匿名性：代理可以增加请求的匿名性，尤其是在需要保护隐私的场景中。
分布式请求：使用多个代理可以分散请求负载，避免被目标网站封禁。

2. DDGS 类支持的代理类型

DDGS 类支持以下代理协议：

HTTP 代理：例如 http://user:pass@example.com:3128
HTTPS 代理：例如 https://user:pass@example.com:3128
SOCKS 代理：例如 socks5://user:pass@example.com:32325

3. 使用代理的四种方式

（1）使用 Tor 浏览器代理

Tor 是一个匿名网络，通过 Tor 浏览器可以隐藏你的 IP 地址。DDGS 类提供了一个简化的方式来使用 Tor 代理。

from duckduckgo_search import DDGS

# 使用 Tor 代理（"tb" 是 "socks5://127.0.0.1:9150" 的别名）
ddgs = DDGS(proxy="tb", timeout=20)

# 搜索 "something you need"，最多返回 50 条结果
results = ddgs.text("something you need", max_results=50)

# 打印结果
for result in results:
    print(result)

说明：

proxy="tb" 是 Tor 代理的别名，等价于 socks5://127.0.0.1:9150。
使用前需要确保 Tor 浏览器已启动，并且代理端口为 9150。

（2）使用自定义代理服务器

你可以使用任何支持 HTTP/HTTPS/SOCKS 协议的代理服务器。以下是一个使用 iproyal 旋转住宅代理 的示例：

from duckduckgo_search import DDGS

# 使用 SOCKS5 代理
ddgs = DDGS(proxy="socks5h://user:password@geo.iproyal.com:32325", timeout=20)

# 搜索 "something you need"，最多返回 50 条结果
results = ddgs.text("something you need", max_results=50)

# 打印结果
for result in results:
    print(result)

说明：

socks5h:// 表示 SOCKS5 代理，并支持域名解析。
user:password 是代理服务器的认证信息。
geo.iproyal.com:32325 是代理服务器的地址和端口。

（3）通过环境变量设置代理

你可以通过设置 DDGS_PROXY 环境变量来指定代理服务器，而不需要在代码中显式传递 proxy 参数。

# 在终端中设置环境变量
export DDGS_PROXY="socks5h://user:password@geo.iproyal.com:32325"

然后在代码中直接使用 DDGS 类，无需指定 proxy 参数：

# 无需指定 proxy 参数，会自动使用环境变量中的代理
ddgs = DDGS(timeout=20)

# 搜索 "something you need"，最多返回 50 条结果
results = ddgs.text("something you need", max_results=50)

# 打印结果
for result in results:
    print(result)

（4）使用旋转代理

旋转代理是一种动态切换 IP 地址的代理服务，适合需要频繁切换 IP 的场景（如爬虫）。以下是一个使用旋转代理的示例：

from duckduckgo_search import DDGS

# 使用旋转代理
ddgs = DDGS(proxy="socks5h://user:password@geo.iproyal.com:32325", timeout=20)

# 搜索 "something you need"，最多返回 50 条结果
results = ddgs.text("something you need", max_results=50)

# 打印结果
for result in results:
    print(result)

说明：

旋转代理会自动切换 IP 地址，因此每次请求可能使用不同的 IP。
如果你不使用旋转代理，可以在每次初始化 DDGS 类时手动更换代理。

4. 注意事项

代理服务器的可用性：确保代理服务器可用且稳定，否则可能导致请求失败。

代理的匿名性：选择高匿名代理（如住宅代理）可以更好地保护隐私。

法律和道德问题：使用代理时请遵守相关法律法规，避免滥用。