A high-performance REST API for interesting facts across multiple domains, built with Bun.

This API provides access to a curated collection of 200 fascinating facts across seven categories:

• 🌌 Astronomy
• 🔬 Biology
• ⚛️ Physics
• 🦁 Animals
• 📜 History
• 💻 Technology
• 🌍 Global Warming

Each fact includes detailed metadata such as verification status, sources, discovery year, and interest rating.

Retrieves a list of facts with optional filtering.

URL: /api/facts
Method: GET
Query Parameters:

• limit (optional): Maximum number of facts to return
• verified (optional): Filter by verification status (true/false)

Success Response:

• Code: 200
• Content: Array of Fact objects

Example Request:

GET /api/facts?limit=5&verified=true

Retrieves a single random fact from the facts collection.

URL: /api/facts/random
Method: GET

Success Response:

• Code: 200
• Content: Single Fact object

Example Request:

GET /api/facts/random

Example Response:

{
 "id": 15,
 "title": "Octopus Intelligence",
 "fact": "Octopuses are highly intelligent and have been observed using tools, solving puzzles, and even escaping from aquariums.",
 "category": "animals",
 "verified": true
}

Retrieves a specific fact by its ID.

URL: /api/facts/:id
Method: GET
URL Parameters:

• id: The numeric ID of the fact

Success Response:

• Code: 200
• Content: Fact object

Error Response:

• Code: 404
• Content: { "error": "Fact not found" }

Example Request:

GET /api/facts/42

Retrieves all facts belonging to a specific category.

URL: /api/facts/category/:category
Method: GET
URL Parameters:

• category: The category name

Success Response:

• Code: 200
• Content: Array of Fact objects

Example Request:

GET /api/facts/category/science

Searches for facts containing the specified query in title, content, or category.

URL: /api/facts/search
Method: GET
Query Parameters:

• q: The search query

Success Response:

• Code: 200
• Content: Array of Fact objects

Example Request:

GET /api/facts/search?q=dinosaur

interface Fact {
 id: number;
 category: Categories;
 title: string;
 fact: string;
 verified: boolean;
 source: string;
 year_discovered: number;
 interesting_rating: number;
}

All facts in this API were curated and provided by Claude AI (Anthropic Claude 3.7 Sonnet).

This project is licensed under the MIT License - see the LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Made with ❤️ and powered by Bun.