Notion

Notion

API Notion для создания и управления страницами, базами данных и блоками.

⭐ 225 · десятки тысяч загрузок · автор — Peter Steinberger (@steipete). Лицензия MIT-0 — свободное использование без ограничений.

Основные операции

Поиск страниц и источников данных:

curl -X POST "https://api.notion.com/v1/search" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03" \
 -H "Content-Type: application/json" \
 -d '{"query": "page title"}'

Получить страницу:

curl "https://api.notion.com/v1/pages/{page_id}" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03"

Получить содержимое страницы (блоки):

curl "https://api.notion.com/v1/blocks/{page_id}/children" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03"

Создать страницу в базе данных:

curl -X POST "https://api.notion.com/v1/pages" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03" \
 -H "Content-Type: application/json" \
 -d '{
 "parent": {"database_id": "xxx"},
 "properties": {
 "Name": {"title": [{"text": {"content": "New Item"}}]},
 "Status": {"select": {"name": "Todo"}}
 }
 }'

Запрос данных из базы:

curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03" \
 -H "Content-Type: application/json" \
 -d '{
 "filter": {"property": "Status", "select": {"equals": "Active"}},
 "sorts": [{"property": "Date", "direction": "descending"}]
 }'

Создать источник данных (базу):

curl -X POST "https://api.notion.com/v1/data_sources" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03" \
 -H "Content-Type: application/json" \
 -d '{
 "parent": {"page_id": "xxx"},
 "title": [{"text": {"content": "My Database"}}],
 "properties": {
 "Name": {"title": {}},
 "Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
 "Date": {"date": {}}
 }
 }'

Обновить свойства страницы:

curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03" \
 -H "Content-Type: application/json" \
 -d '{"properties": {"Status": {"select": {"name": "Done"}}}}'

Добавить блоки на страницу:

curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
 -H "Authorization: Bearer $NOTION_KEY" \
 -H "Notion-Version: 2025-09-03" \
 -H "Content-Type: application/json" \
 -d '{
 "children": [
 {
 "object": "block",
 "type": "paragraph",
 "paragraph": {
 "rich_text": [{"text": {"content": "Hello"}}]
 }
 }
 ]
 }'

Типы свойств

Основные форматы свойств в элементах базы данных:

• Title: {«title»: [{«text»: {«content»: «…»}}]}
• Rich text: {«rich_text»: [{«text»: {«content»: «…»}}]}
• Select: {«select»: {«name»: «Option»}}
• Multi-select: {«multi_select»: [{«name»: «A»}, {«name»: «B»}]}
• Date: {«date»: {«start»: «2024-01-15», «end»: «2024-01-16»}}
• Checkbox: {«checkbox»: true}
• Number: {«number»: 42}
• URL: {«url»: «https://…»}
• Email: {«email»: «a@b.com»}
• Relation: {«relation»: [{«id»: «page_id»}]}

Ключевые изменения (версия 2025-09-03)

• Databases переименованы в Data Sources
• Для работы используется endpoint /data_sources/
• Каждая база имеет два идентификатора: database_id и data_source_id
• Результаты поиска возвращают объект типа «data_source»
• Ответы страниц содержат оба ID в parent

Примечания

• ID страниц и баз — UUID (с дефисами или без)
• API не управляет фильтрами представлений (только UI)
• Лимит запросов: ~3 запроса в секунду
• Параметр is_inline позволяет встроить базу в страницу