Rust client library for the Discourse API.

Features

Fetch latest topics
Get categories
Get topic details with posts
Get individual posts
Filter topics by category
Async/await support with tokio
Optional authentication with API keys

Installation

[dependencies]
discourse-api = "0.20251116"

Usage

Basic (unauthenticated)

use discourse_api::DiscourseClient;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = DiscourseClient::new("https://meta.discourse.org");
    let topics = client.get_latest().await?;
    for topic in topics.topics {
        println!("{}", topic.title);
    }
    Ok(())
}

With API Authentication

let client = DiscourseClient::with_api_key(
    "https://your-forum.com",
    "your-api-key",
    "your-username"
);
let topics = client.get_latest().await?;

Examples

Run the example:

cargo run --example fetch_latest

API Endpoints

get_latest() - Get latest topics
get_categories() - Get all categories
get_topic(id) - Get topic with posts
get_post(id) - Get individual post
get_category_topics(category_id) - Get topics in category

License

MIT