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

[中文]

用途:

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

参数:

• 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

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"

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.