Notion API Cheat Sheet

Last Updated: November 21, 2025

Auth & Rate Limits

Topic	Notes
`OAuth`	Use for user-authorized automations
`Internal integrations`	Use for owned workspace scripts
`Rate limit`	3 requests/sec per token
`Concurrency`	Queue to stay under limits


         fetch('https://api.notion.com/v1/pages', {...})

Create or update pages


         Notion SDK client.pages.create

Add rows to a database


         client.databases.query

Filter + sort rows


         client.blocks.children.append

Append content

Cache block IDs, use `query` filters for pagination, and include user-friendly error handling.

💡 Pro Tip: Use a dedicated integration per workspace and cache tokens securely.