The API Report CardAPI Index
Notion

Notion API

Workspace platform · notion.so

Notion's public REST API is mature and versioned via the Notion-Version header, covering pages, databases, blocks, users, search, and native HMAC-signed webhooks. Access is self-serve with internal tokens or OAuth 2.0 for multi-workspace apps. Rate limits average 3 requests per second.

Last verified: August 2026Software & Data ToolsMCP READY
API GRADE
A
VERIFIED AUG 2026

SCORECARD

ExistenceGOODA versioned REST API at api.notion.com/v1 covers pages, blocks, databases, views, users, comments, search, and webhooks.
AccessGOODSelf-serve: internal connection tokens for one workspace, OAuth 2.0 public connections for multi-workspace apps, and PATs.
CoverageGOODPage and block CRUD, database queries with filters, views, comments with threading, file uploads, and workspace search.
AuthGOODThree token models: internal tokens, OAuth 2.0 with introspect and revoke endpoints, and user-scoped personal access tokens.
Docs & DXGOODOfficial @notionhq/client SDK, cursor pagination, native HMAC-signed webhooks, and docs at developers.notion.com.
StabilityGOODExplicit versioning via the Notion-Version header, with dated platform versions and published release notes.
MCPGOODNotion publishes an official hosted MCP server at mcp.notion.com with OAuth, covering search, reading, creating, and updating pages, databases, and comments. Connection guides live on developers.notion.com, and Notion also maintains an open-source local server on GitHub under the makenotion org. developers.notion.com VERIFIED 2026-08
Supergood turns hard-to-integrate enterprise software into clean REST APIs and MCP tools: stable endpoints, normalized JSON, managed auth.

Frequently asked questions

Notion scores A on Supergood's API Report Card. Notion's public REST API is mature and versioned via the Notion-Version header, covering pages, databases, blocks, users, search, and native HMAC-signed webhooks. Access is self-serve with internal tokens or OAuth 2.0 for multi-workspace apps. Rate limits average 3 requests per second.

Tried to integrate with Notion?