pytrends 项目使用教程

pytrends 项目使用教程

pytrends Pseudo API for Google Trends 项目地址: https://gitcode.com/gh_mirrors/py/pytrends

1. 项目目录结构及介绍

pytrends 项目是一个用于自动化获取 Google 趋势数据的开源项目。以下是项目的目录结构及其简要介绍：

pytrends/
├── .github/              # GitHub 工作流和配置文件
│   └── workflows/
├── examples/             # 示例代码和脚本
├── pytrends/             # pytrends 库的主要代码
│   ├── __init__.py
│   ├── request.py        # 请求 Google 趋势数据的类
│   ├── trends.py         # 趋势分析的方法
│   └── ...
├── tests/                # 测试代码
├── .gitattributes         # Git 属性配置文件
├── .gitignore            # Git 忽略文件
├── CONTRIBUTING.md       # 贡献指南
├── LICENSE               # 许可证文件
├── MANIFEST.in           # 打包时包含的文件列表
├── README.md             # 项目说明文件
├── pyproject.toml        # 项目元数据和依赖
└── requirements-*.txt    # 项目依赖文件

2. 项目的启动文件介绍

在 pytrends 项目中，没有特定的“启动文件”。用户通常通过在 Python 环境中导入 pytrends 模块来使用它。以下是一个简单的示例，展示了如何使用 pytrends：

from pytrends.request import TrendReq

# 创建 TrendReq 实例
pytrends = TrendReq(hl='zh-CN', tz=8*60)

# 构建请求数据
kw_list = ["区块链"]
pytrends.build_payload(kw_list, cat=0, timeframe='today 5-y', geo='', gprop='')

# 获取兴趣随时间的变化数据
data = pytrends.interest_over_time()
print(data)

在上面的代码中，我们首先导入了 pytrends.request 模块中的 TrendReq 类，然后创建了一个 TrendReq 实例，并设置了语言和时区。接着，我们构建了请求数据，并获取了兴趣随时间的变化数据。

3. 项目的配置文件介绍

pytrends 项目的配置主要通过代码中的参数设置来实现。以下是一些常用的配置参数：

• hl: 指定访问 Google 趋势时的语言，例如 'zh-CN'。
• tz: 时区偏移量（分钟），例如中国是 8*60。
• proxies: 如果被 Google 限制访问，可以设置代理，例如 ['https://34.203.233.13:80']。
• timeout: 连接和读取的超时时间。
• retries: 重试次数。
• backoff_factor: 重试之间的退避因子。

此外，pyproject.toml 文件包含了项目的元数据和依赖信息，例如：

[build-system]
requires = ["setuptools", "wheel"]

[tool.setuptools]
packages = find:
python_requires = >=3.7

requirements.txt 文件包含了项目运行所需的外部库依赖，例如：

requests
lxml
pandas

这些配置文件和参数确保了 pytrends 项目能够正确地运行和配置。

pytrends Pseudo API for Google Trends 项目地址: https://gitcode.com/gh_mirrors/py/pytrends