NotionNotion 协作工作区 API
POST/v1/data_sources/{data_source_id}/query
查询数据源内容
按过滤、排序与分页条件查询数据源中的条目(页面)。
通过官方版本化 Notion API 管理页面、块、数据源/数据库、评论、文件上传、视图、用户与搜索,并支持 OAuth 与异步任务。完整边界为官方 OpenAPI 快照中的 49 个 Endpoint;工作区数据为私有用户内容,Pontx 不代理、缓存或聚合,调用方使用本地 SDK/CLI 直连。
请求
- operationId
queryDataSource- 服务器
https://api.notion.com- 认证
- bearerAuth, basicAuth
请求参数
data_source_id
pathidRequest必填
filter_properties
queryarray
仅返回指定属性的值。
Notion-Version
headerstring必填
请求使用的 API 版本日期;当前最新版本为 2026-03-11。
2026-03-11
Body 参数
object必填
字段: filteris_archivedpage_sizeresult_typesortsstart_cursor
响应
200
objectapplication/json
请求成功。
字段: has_morenext_cursorobjectpage_or_data_sourcerequest_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 相同方式重试。
{
"has_more": true,
"next_cursor": "example content",
"object": "list",
"page_or_data_source": {},
"request_status": {
"incomplete_reason": "query_result_limit_reached",
"type": "complete"
},
"results": [],
"type": "page_or_data_source"
}