\### 接口概览

本接口用于获取各大平台今日热榜的排行数据。不传入任何参数时，将返回支持的平台列表（如 36氪、哔哩哔哩、知乎等）。传入指定平台标题后，可获取该平台的热点排行详情。



\### 请求地址

`https://api.pearapi.ai/api/dailyhot/`



\### 请求方式

GET



\### 返回格式

JSON



\### 权限/付费要求

免费接口，无需付费或特殊权限。



\### 请求参数说明

| 参数名 | 是否必填 | 用途 |

| :--- | :--- | :--- |

| `title` | 是 | 平台标题，用于指定要获取热榜的平台，例如“哔哩哔哩”。不传入此参数时，接口返回所有支持的平台列表。 |



\### 默认请求示例

```json

{

&#x20;   "title": "哔哩哔哩"

}

```

对应的实际请求 URL 示例为：

`https://api.pearapi.ai/api/dailyhot/?title=哔哩哔哩`



\### 返回字段说明

| 字段路径 | 类型 | 描述 |

| :--- | :--- | :--- |

| `code` | integer | 状态码，表示请求结果 |

| `name` | string | 平台名称，如“哔哩哔哩” |

| `title` | string | 热点标题 |

| `type` | string | 榜单名称，如“热门视频” |

| `description` | string | 平台描述 |

| `link` | string | 来源目标链接 |

| `total` | integer | 获取到的热点数量 |

| `updateTime` | string | 数据更新时间 |

| `formCache` | string | 是否从缓存中获取（“是”或“否”） |

| `data` | string | 返回的热点数据列表，内部包含多个热点对象 |

| `data\[].id` | integer | 热点ID |

| `data\[].desc` | string | 热点描述 |

| `data\[].cover` | string | 热点封面图片链接 |

| `data\[].hot` | string | 热点热度数值 |

| `data\[].timestamp` | string | 热点时间戳 |

| `data\[].url` | string | 热点链接 |

| `data\[].mobileUrl` | string | 热点手机端链接 |



\### 返回示例

由于原配置中未提供示例结果，以下为根据字段结构构造的典型返回示例：

```json

{

&#x20;   "code": 200,

&#x20;   "name": "哔哩哔哩",

&#x20;   "title": "哔哩哔哩热门视频",

&#x20;   "type": "热门视频",

&#x20;   "description": "哔哩哔哩弹幕视频网热门内容",

&#x20;   "link": "https://www.bilibili.com/",

&#x20;   "total": 50,

&#x20;   "updateTime": "2025-04-10 12:00:00",

&#x20;   "formCache": "否",

&#x20;   "data": \[

&#x20;       {

&#x20;           "id": 1,

&#x20;           "desc": "这是一个热门视频的简介",

&#x20;           "cover": "https://example.com/cover.jpg",

&#x20;           "hot": "123456",

&#x20;           "timestamp": "2025-04-10 11:30:00",

&#x20;           "url": "https://www.bilibili.com/video/example",

&#x20;           "mobileUrl": "https://m.bilibili.com/video/example"

&#x20;       }

&#x20;   ]

}

```



\### 对接注意事项

1\. \*\*参数传递\*\*：`title` 参数必须通过 URL 查询字符串传递，如 `?title=哔哩哔哩`。

2\. \*\*平台名称\*\*：`title` 的值需与接口返回的平台列表中的名称完全一致，包括大小写和标点符号。

3\. \*\*返回结构\*\*：当不传入 `title` 时，返回的数据结构可能与传入 `title` 时不同，建议先测试无参数请求以获取平台列表。

4\. \*\*数据时效性\*\*：`updateTime` 和 `formCache` 字段可判断数据是否为最新，建议根据业务需求决定是否信任缓存数据。



\### 给 AI 助手的实现建议

1\. \*\*请求构建\*\*：使用 HTTP GET 方法，将 `title` 参数附加到 URL 后。如果用户未提供 `title`，则直接请求基础 URL。

2\. \*\*错误处理\*\*：检查返回的 `code` 字段，非 200 时视为请求失败，需提示用户或重试。

3\. \*\*数据解析\*\*：`data` 字段是一个数组，需遍历处理每个热点对象，提取 `id`、`desc`、`cover`、`hot`、`timestamp`、`url`、`mobileUrl` 等字段。

4\. \*\*平台列表获取\*\*：若用户未指定平台，可先调用无参数接口获取平台列表，再引导用户选择。

5\. \*\*编码问题\*\*：URL 中的中文字符（如“哔哩哔哩”）需进行 URL 编码，确保请求正确。

