notion-client

Notion API client library for rust. Now, this library supports all endpoints except authentication!

Getting Started

Example for Query a Database

• Corresponding API
  • Query a database

use notion_client::endpoints::{
    databases::query::request::{QueryDatabaseRequest, Sort, SortDirection, Timestamp},
    Client,
};

const NOTION_DB_ID: &str = ""; // ⚠️ Set your DB id which can be accessible from API
const NOTION_TOKEN: &str = ""; // ⚠️ Set your notion token

#[tokio::main]
async fn main() {
    // Initialize client
    let client = Client::new(NOTION_TOKEN.to_string(), None);
    let Ok(client) = client else {
        panic!("error");
    };

    // Set up request parameters
    let request = QueryDatabaseRequest {
        sorts: Some(vec![Sort::Timestamp {
            timestamp: Timestamp::CreatedTime,
            direction: SortDirection::Ascending,
        }]),
        ..Default::default()
    };

    // Send request
    let res = client
        .databases
        .query_a_database(NOTION_DB_ID, request)
        .await;

    // See result
    print!("{:#?}", res);
}

See more examples

TODO

• support threadsafe
• add more examples
• support blocks endpoint
• support pages endpoint
• support databases endpoint
• support users endpoint
• support comments endpoint
• support search endpoint
• support authentication endpoint
• add test to blocks endpoint
• add test to pages endpoint
• add test to databases endpoint
• add test to users endpoint
• add test to comments endpoint
• add test to search endpoint
• support builder pattern

Contributing

Contributions are always welcome! If you have an idea, it's best to float it by us before working on it to ensure no effort is wasted. If there's already an open issue for it, knock yourself out.

If you have any questions, feel free to use Discussions. Please don't hesitate to ask questions!