[中文]

用途:

获取指定话题下的笔记列表，支持按最热或最新排序，使用游标分页

⚠️ 计费提示:

如果传入错误或不存在的话题页面ID，接口仍会正常响应，但 data 中会返回上游"服务异常"信息，该请求 同样会正常计费扣费，请在调用前确保参数有效。

参数:

page_id: 话题页面ID（必需），如 "5c1cc866febed9000184b7c1"

可以从单一笔记接口获取或搜索接口

sort: 排序方式

"trend": 最热（默认）

"time": 最新

cursor_score: 分页游标分数，翻页时传入上一页最后一个 item 的 cursor_score

last_note_id: 上一页最后一条笔记ID，翻页时传入

last_note_ct: 上一页最后一条笔记创建时间，翻页时传入

session_id: 会话ID，翻页时保持一致

first_load_time: 首次加载时间戳，翻页时保持一致

source: 来源，默认 "normal"

话题笔记列表数据

翻页说明:

首次请求：只传 page_id 和 sort，其余留空

翻页请求：取上一次响应最后一个 item 的字段:

cursor_score ← items[-1].cursor_score

last_note_id ← items[-1].id

last_note_ct ← items[-1].create_time

建议同时回传 session_id 和 first_load_time 保持会话一致

[English]

Purpose:

Get notes list under a specified topic, supports sorting by trending or latest, using cursor pagination

⚠️ Billing Notice:

If a wrong or non-existent topic page ID is passed, the endpoint still responds normally, but the data field will contain an upstream "service error" message. Such requests will still be billed as normal. Please make sure the parameters are valid before calling.

Parameters:

page_id: Topic page ID (required), e.g. "5c1cc866febed9000184b7c1"

Can be obtained from single note API or search API

sort: Sort type

"trend": Trending (default)

"time": Latest

cursor_score: Pagination cursor score, pass last item's cursor_score from previous response

last_note_id: Last note ID from previous page

last_note_ct: Last note create time from previous page

session_id: Session ID, keep consistent for pagination

first_load_time: First load timestamp, keep consistent for pagination

source: Source, default "normal"

Return:

Topic notes list data

Pagination Guide:

First request: only pass page_id and sort, leave others empty

Next page: pass fields from last item of previous response:

cursor_score ← items[-1].cursor_score

last_note_id ← items[-1].id

last_note_ct ← items[-1].create_time

Recommended to also pass session_id and first_load_time for session consistency

[示例/Example]

page_id="5c1cc866febed9000184b7c1"
sort="trend"

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

获取话题笔记列表/Get topic feed

[中文]

用途:

⚠️ 计费提示:

参数:

返回:

翻页说明:

[English]

Purpose:

⚠️ Billing Notice:

Parameters:

Return:

[示例/Example]

Request

Request Code Samples

Responses

获取话题笔记列表/Get topic feed

[中文]#

用途:#

⚠️ 计费提示:#

参数:#

返回:#

翻页说明:#

[English]#

Purpose:#

⚠️ Billing Notice:#

Parameters:#

Return:#

Pagination Guide:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

⚠️ 计费提示:

参数:

返回:

翻页说明:

[English]

Purpose:

⚠️ Billing Notice:

Parameters:

Return:

Pagination Guide:

[示例/Example]