Notion API免费3年，用户用它造出了什么狠东西|json|代码|命令提示符

2021年5月，Notion（一款笔记与项目管理工具）开放了应用程序接口（API）的公测。个人用户完全免费，所有付费计划都包含在内。三年过去，这个看似"开发者专属"的功能，已经被普通用户玩出了花——有人用它自动生成每日站会文档，有人把邮件里的潜在客户直接写进数据库，还有人把Dev.to（一个开发者内容平台）的文章同步到内容日历。

但大多数人甚至不知道这个功能存在。

这不是你的问题。Notion的产品设计出了名的"克制"，API入口藏得比某些手机的开发者选项还深。今天这篇，我们直接上代码，看看这个免费工具到底能干什么，以及为什么它可能是你被低估的效率杠杆。

第一步：拿到你的"钥匙"

任何API调用都需要认证。Notion用的是Bearer Token（令牌认证），获取方式比想象中简单：进入Notion设置 → 集成 → 新建集成 → 复制Token。不需要信用卡，不需要企业邮箱，个人账号直接开搞。

代码层面，你只需要这几行：

TOKEN = "your_notion_api_key"

HEADERS = {

"Authorization": f"Bearer {TOKEN}",

"Content-Type": "application/json",

"Notion-Version": "2022-06-28"

注意那个Notion-Version字段。这是2022年6月的版本号，至今仍是主流。Notion的API迭代不算快，但足够稳定——对于不想频繁改代码的用户来说，这是好消息。

查询数据库：比筛选器灵活10倍

Notion原生的筛选器已经很强，但API查询能做到它做不到的事：跨数据库关联、条件组合、自动化触发。

比如这段代码，查询某个数据库里所有Status（状态）为"Done"（已完成）的条目：

def query_database(db_id, filter_obj=None):

data = {}

if filter_obj:

data["filter"] = filter_obj

r = requests.post(f"https://api.notion.com/v1/databases/{db_id}/query",

headers=HEADERS, json=data)

results = r.json()["results"]

return [{"id": p["id"], "props": {k: v for k, v in p["properties"].items()}}

for p in results]

items = query_database("your_db_id", {

"property": "Status",

"status": {"equals": "Done"}

返回的是结构化数据，你可以直接丢给Pandas做分析，或者发给Slack机器人。原生筛选器做不到这种"数据出口"的自由。

创建页面：把重复劳动交给代码

每天手动创建站会文档？从邮件复制客户信息到CRM（客户关系管理系统）？这些重复动作都可以用create_page函数解决。

def create_page(db_id, title, status="Not started"):

data = {

"parent": {"database_id": db_id},

"properties": {

"Name": {"title": [{"text": {"content": title}}]},

"Status": {"status": {"name": status}}

r = requests.post("https://api.notion.com/v1/pages",

headers=HEADERS, json=data)

return r.json()["id"]

page_id = create_page("db_id", "New task from Python")

关键点在于properties字段的构造。Notion的属性类型有title（标题）、status（状态）、select（单选）、multi_select（多选）、date（日期）等十几种，每种在API里的JSON结构都不一样。官方文档有完整对照表，但说实话，第一次对接时你可能会骂娘——这种"灵活性"的代价就是学习曲线。

但一旦跑通，你就拥有了一个可编程的笔记系统。