Welcome to the official documentation for notion-sdk-php, a comprehensive PHP library for interacting with the Notion API. This SDK provides a clean, object-oriented interface to all Notion API endpoints, making it easy to build powerful integrations with Notion workspaces.
What is notion-sdk-php?
notion-sdk-php is the unofficial PHP implementation of the Notion SDK, designed to provide PHP developers with a robust and intuitive way to work with Notion’s API. The library follows modern PHP best practices, implements PSR standards, and provides comprehensive error handling and type safety.
Key Features
- Complete API Coverage: Support for all Notion API endpoints (pages, databases, blocks, users, comments, search)
- Type Safety: Strongly typed resource objects with full IDE support
- PSR Compliance: Follows PSR-18 for HTTP clients and PSR-4 for autoloading
- Flexible HTTP Client: Works with any PSR-18 compatible HTTP client (Guzzle, Symfony, cURL)
- Comprehensive Error Handling: Detailed exception hierarchy for robust error management
- Pagination Support: Built-in pagination handling for large result sets
- Rate Limiting: Tools and patterns for handling API rate limits gracefully
Ready to get started? Head over to the Installation to begin!
