Notion/listComments

暂不支持在线调用 · 原因见下方

NotionNotion 协作工作区 API

GET/v1/comments

列出评论

按块或页面返回评论列表。

通过官方版本化 Notion API 管理页面、块、数据源/数据库、评论、文件上传、视图、用户与搜索，并支持 OAuth 与异步任务。完整边界为官方 OpenAPI 快照中的 49 个 Endpoint；工作区数据为私有用户内容，Pontx 不代理、缓存或聚合，调用方使用本地 SDK/CLI 直连。

请求

operationId: listComments
服务器: https://api.notion.com
认证: bearerAuth, basicAuth

请求参数

`block_id`

queryidRequest必填

`start_cursor`

querystring

分页起始游标（不透明）。

example content

`page_size`

queryinteger

每页返回条数。

`Notion-Version`

headerstring必填

请求使用的 API 版本日期；当前最新版本为 2026-03-11。

2026-03-11

响应

`200`

objectapplication/json

请求成功。

字段: commenthas_morenext_cursorobjectrequest_statusresultstype

`400`

error_api_400application/json

请求参数无效。

`401`

error_api_401application/json

未认证或令牌无效。

`403`

error_api_403application/json

无权限访问该资源。

`404`

error_api_404application/json

未找到指定资源。

`406`

error_api_406application/json

请求无法按要求表示。

`409`

error_api_409application/json

请求与资源当前状态冲突。

`429`

error_api_429application/json

请求频率超限，请遵循 Retry-After 后重试。

`500`

error_api_500application/json

上游服务内部错误。

`503`

error_api_503application/json

上游服务暂时不可用。

`504`

error_api_504application/json

上游网关超时。

`529`

error_api_529application/json

上游服务过载，请按 429 相同方式重试。

{
  "comment": {},
  "has_more": true,
  "object": "list",
  "request_status": {
    "incomplete_reason": "query_result_limit_reached",
    "type": "complete"
  },
  "results": {
    "attachments": [
      {}
    ],
    "created_by": {
      "id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
      "object": "user"
    },
    "created_time": "2026-03-11T00:00:00.000Z",
    "discussion_id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
    "display_name": {
      "resolved_name": "example content",
      "type": "custom"
    },
    "id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
    "last_edited_time": "2026-03-11T00:00:00.000Z",
    "object": "comment"
  },
  "type": "comment"
}