{ "openapi": "3.0.1", "info": { "title": "Notion API - Database & Page Automation", "description": "Automate your Notion workspace with the official API. Query databases, create and update pages, manage blocks, search content, and sync data. Perfect for CMS automation, content pipelines, project management, and knowledge base workflows.", "version": "1.0", "x-build-id": "Hvho5o4gxYfdkfbnt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~notion-api---database-page-automation/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-notion-api---database-page-automation", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/alizarin_refrigerator-owner~notion-api---database-page-automation/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-notion-api---database-page-automation", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/alizarin_refrigerator-owner~notion-api---database-page-automation/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-notion-api---database-page-automation", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "task" ], "properties": { "task": { "title": "Task", "enum": [ "search", "query_database", "get_database", "create_database", "update_database", "get_page", "create_page", "update_page", "get_block", "get_block_children", "append_block_children", "update_block", "delete_block", "list_users", "get_user", "get_me", "list_comments", "create_comment", "batch_create_pages" ], "type": "string", "description": "Operation to perform", "default": "search" }, "accessToken": { "title": "Integration Token", "type": "string", "description": "Notion integration token (starts with 'secret_')" }, "databaseId": { "title": "Database ID", "type": "string", "description": "Notion database ID for database operations" }, "pageId": { "title": "Page ID", "type": "string", "description": "Notion page ID for page operations" }, "blockId": { "title": "Block ID", "type": "string", "description": "Notion block ID for block operations" }, "userId": { "title": "User ID", "type": "string", "description": "Notion user ID for user operations" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Text to search for in page/database titles" }, "searchFilter": { "title": "Search Filter", "enum": [ "page", "database" ], "type": "string", "description": "Filter search results by object type" }, "filter": { "title": "Database Filter", "type": "object", "description": "Filter object for database queries (JSON)", "default": {} }, "sorts": { "title": "Database Sorts", "type": "array", "description": "Sort configuration for database queries (JSON array)", "default": [] }, "pageTitle": { "title": "Page Title", "type": "string", "description": "Title for new page" }, "properties": { "title": "Page/Database Properties", "type": "object", "description": "Properties object for create/update operations (JSON)", "default": {} }, "content": { "title": "Page Content", "type": "array", "description": "Block content to add to page (JSON array of blocks)", "default": [] }, "parentPageId": { "title": "Parent Page ID", "type": "string", "description": "Parent page ID for creating databases or pages" }, "databaseTitle": { "title": "Database Title", "type": "string", "description": "Title for new database" }, "databaseProperties": { "title": "Database Schema", "type": "object", "description": "Property schema for database (JSON object defining columns)", "default": {} }, "commentContent": { "title": "Comment Content", "type": "string", "description": "Rich text content for comments" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of results to return", "default": 20 }, "batchPages": { "title": "Batch Pages", "type": "array", "description": "Array of page objects for batch creation", "default": [] }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to send results to (Zapier, Make, n8n, etc.)" }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run with sample data (no integration token required)", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }