Metadata-Version: 2.4
Name: python-sph
Version: 1.0.0
Summary: 微信视频号剧集数据收入获取项目
Author: Cruter
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pillow~=12.1.1
Requires-Dist: qrcode~=8.2
Requires-Dist: cryptography~=46.0.5
Requires-Dist: curl-cffi~=0.14.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 微信视频号剧集数据收入获取项目

## 项目概述
本项目提供接口，用于自动化获取指定微信视频号的剧集相关收益与播放数据。

## 接口说明

### 1. 获取登录二维码
此接口用于获取微信扫码登录所需的二维码图片（Base64格式）。

**接口调用**
```python
from python_sph.sdk.sph_driver import SphDriver

base64 = SphDriver.get_login_qrcode_base64()
```

**返回参数**

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `code` | Integer | 状态码。`0`表示成功，非`0`表示错误。 |
| `data` | String | Base64格式的二维码图片数据，可直接用于前端渲染。格式为：`data:image/png;base64,......` |

**注意**: 生成的二维码有效期为 **5分钟**，过期后需重新获取。

---

### 2. 获取剧目单日统计收益数据
此接口用于获取视频号在指定日期的详细剧集数据概览，数据来源对应后台的“下载数据”功能。

**接口调用**
```python
from python_sph.sdk.sph_driver import SphDriver

data = SphDriver.get_detailed_data_statistic(sph_id, date_time)
```

**请求参数**

| 参数名 | 类型 | 是否必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `sph_id` | String | 是 | 视频号ID，格式为 `"sph...."`。 |
| `date_time` | Integer | 是 | 需要获取数据的日期时间戳（单位：秒）。 |

**返回参数**

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `code` | Integer | 状态码。`0`表示成功，非`0`表示错误。 |
| `data` | List\<Object\> | 数据列表，每个对象包含单日统计数据。 |

**`data` 列表中对象的字段说明**

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `date` | String | 数据对应的日期。 |
| `sph_id` | String | 视频号ID。 |
| `is_mount` | Boolean | 剧集是否挂载。`True`为是，`False`为否。 |
| `feed_read_count` | Integer | 视频素材播放量。 |
| `drama_read_count` | Integer | 剧集播放量。 |
| `iaa_income` | Integer | 广告变现收入，单位为**分**。 |
| `sph_nickname` | String | 视频号昵称。 |

**注意**:
1.  接口的响应时间与数据量正相关，数据量越小则响应越快。
2.  关于日期参数 `date_time` 的可用范围，请以当前数据库的实际查询能力为准。
