百度统计 API 的 Python 封装
账号类型 | 支持情况 |
---|---|
百度商业账号 | ❌ |
百度账号 | ✅ |
API | 支持情况 |
---|---|
Token 刷新 | ✅ |
站点列表 | ✅ |
网站概况(趋势数据) | ✅ |
网站概况(地域分布) | ✅ |
网站概况(来源网站、搜索词、入口页面、受访页面) | ✅ |
趋势分析 | ✅ |
实时访客 | ✅ |
推广方式 | ❌ |
百度推广趋势 | ❌ |
全部来源 | ✅ |
搜索引擎 | ✅ |
搜索词 | ✅ |
外部链接 | ✅ |
指定广告跟踪 | ❌ |
受访页面 | ✅ |
入口页面 | ✅ |
受访域名 | ✅ |
地域分布 | ✅ |
地域分布(按国家) | ✅ |
百度统计官方文档:
具体使用详见源代码,下面是对项目结构:
baidutongji
├── __init__.py
├── api.py # API 定义
├── data.py # 可选参数数据结构
└── metrics.py # 各 API 筛选指标数据结构
使用样例:
- 查询站点今天的网站概况(趋势数据)报表:
或者可以简化:
import baidutongji baidutongji.getTimeTrendRpt('{ACCESS_TOKEN}', '{SITE_ID}', datetime.date.today(), datetime.date.today(), TimeTrendRptMetrics(pv_count=True, visitor_count=True, ip_count=True, bounce_ratio=True, avg_visit_time=True))
import baidutongji baidutongji.getTimeTrendRpt('{ACCESS_TOKEN}', '{SITE_ID}', datetime.date.today(), datetime.date.today(), TimeTrendRptMetrics().setAllTrue())
- 查询
2022/01/01 ~ 2022/01/10
与2022/04/01 ~ 2022/04/10
趋势分析对比报表,指定时间粒度以天为单位,筛选用户为老用户,访问设备为 PC,地区为上海市:import baidutongji baidutongji.getTrendTime('{ACCESS_TOKEN}', '{SITE_ID}', datetime.date(2022, 1, 1), datetime.date(2022, 1, 10), TrendTimeMetrics().setAllTrue(), datetime.date(2022, 4, 1), datetime.date(2022, 4, 10), Source.ALL, ClientDevice.PC, VisitorType.RETURN, TimeGran.DAY, Region(RegionType.PROVINCE, '上海'))