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: July 2026Software & Data Tools
API GRADE
A
VERIFIED JUL 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.
Supergood: Notion shipped a real API. Most vendors don't; we ship near-native APIs for the rest.

Frequently asked questions

Notion scores A on the 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?