You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Notion API中获取Block ID?

如何获取Notion API追加子块操作所需的Block ID

手动获取(适用于少量Block场景)

  • 打开Notion的网页端/桌面端,定位到目标Block(如果是给整个页面追加子块,直接定位到对应页面即可)
  • 右键点击Block内容(或点击Block左侧的六点拖拽手柄),在弹出菜单中选择「复制链接」
  • 从复制的链接中提取32位字符串即可:链接格式通常为https://www.notion.so/[自定义前缀/工作空间标识]/[ID部分]?[其他参数],其中ID部分如果包含横杠,直接删除所有横杠,最终得到的32位字母数字组合就是可用的Block ID

API批量获取(适用于大量Block场景)

如果需要批量获取多个Block的ID,可以调用Notion的块子项检索接口:

  • 先获取父级Block(比如页面)的ID,调用GET /v1/blocks/{parent_block_id}/children接口
  • 接口返回的子块列表中,每个条目自带的id字段就是对应子块的有效ID,可直接传入后续追加子块的接口使用,不需要额外处理格式

补充:Notion内所有元素(页面、文本、表格、图片、数据库等)本质都是Block,ID规则完全一致,上述方法通用

注意:操作前请确认你的Notion集成已经获得了对应Block所在页面的访问权限,否则即使拿到正确ID也无法调用接口执行操作

内容的提问来源于stack exchange,提问作者kevin liu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 10:15:04