[中文]

用途:

根据话题标签获取相关笔记

参数:

page_id: 话题标签ID（必需）

first_load_time: 首次请求的时间戳，毫秒级时间戳（必需）

例子: 1698647850000

Python获取当前时间戳: int(time.time() * 1000)

sort: 排序方式

"hot": 综合排序（默认）

"time": 最新发布

"trend": 最热门

session_id: 会话ID，首次不传，由服务端生成，翻页时传入

last_note_ct: 最后一条笔记的create_time字段，首次不传，翻页时传入

last_note_id: 最后一条笔记的ID，首次不传，翻页时传入

cursor_score: 最后一条笔记的cursor_score字段，首次不传，翻页时传入

话题笔记数据，包含：

notes: 笔记列表数组，每个元素包含：

id: 元素ID

model_type: 模型类型（通常为"note"）

note: 笔记详情对象

note_id: 笔记ID

title: 标题

desc: 描述

type: 类型（normal/video）

user: 作者信息

interact_info: 互动数据

cover: 封面图

create_time: 创建时间戳

cursor_score: 游标分数（用于翻页）

session_id: 会话ID（翻页必需）

has_more: 是否有更多数据

翻页说明:

首次请求：只传page_id和first_load_time

翻页请求：需要传入

上一次返回的session_id

最后一条笔记的last_note_ct（create_time）

最后一条笔记的last_note_id（id）

最后一条笔记的cursor_score

[English]

Purpose:

Get notes by topic tag

Parameters:

page_id: Topic tag ID (required)

first_load_time: First load timestamp in milliseconds (required)

Example: 1698647850000

Get current timestamp in Python: int(time.time() * 1000)

sort: Sort method

"hot": Comprehensive (default)

"time": Latest published

"trend": Trending

session_id: Session ID, not required for first request, use returned value for pagination

last_note_ct: Last note create_time field for pagination

last_note_id: Last note ID for pagination

cursor_score: Last note cursor_score field for pagination

Return:

Topic notes data containing:

notes: Notes list array, each element includes:

id: Element ID

model_type: Model type (usually "note")

note: Note detail object

note_id: Note ID

title: Title

desc: Description

type: Type (normal/video)

user: Author info

interact_info: Interaction data

cover: Cover image

create_time: Creation timestamp

cursor_score: Cursor score (for pagination)

session_id: Session ID (required for pagination)

has_more: Whether has more data

Pagination Guide:

First request: Only pass page_id and first_load_time

Next requests: Need to pass

session_id from previous response

last_note_ct (create_time of last note)

last_note_id (id of last note)

cursor_score of last note

[示例/Example]

page_id="5c014b045b29cb0001ead530"
first_load_time="1698647850000"
sort="hot"

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

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "2025-09-20 00:25:53",
    "time_stamp": 1758353153,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

根据话题标签获取作品/Get notes by topic

[中文]

用途:

参数:

返回:

翻页说明:

[English]

Purpose:

Parameters:

Return:

[示例/Example]

Request

Request Code Samples

Responses

根据话题标签获取作品/Get notes by topic

[中文]#

用途:#

参数:#

返回:#

翻页说明:#

[English]#

Purpose:#

Parameters:#

Return:#

Pagination Guide:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

返回:

翻页说明:

[English]

Purpose:

Parameters:

Return:

Pagination Guide:

[示例/Example]