Skip to content

ODIN API is a lightweight, high‑performance Cloudflare Worker that exposes structured access to Norse literary texts. Designed for developers, linguists, and researchers, it delivers stanzas in multiple languages and writing systems through a simple, fast, globally distributed API.

Notifications You must be signed in to change notification settings

n1h1lius/ODIN-API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ODIN API


ᚠᛁᚾ:ᚦᚢ:ᛚᛁᚦ:ᚦᛁᚾᛅ:ᛁᚦᛅ:ᛋᛘᛁᚦ:ᛁᚾᛅ


License: MIT Cloudflare Workers Status

A lightweight, blazing-fast API for retrieving stanzas from Norse texts, built on the edge.

ODIN API provides structured access to mythological and historical Nordic works, starting with the Hávamál in multiple languages and ancient writing systems.


⚡ Quick Start

Base URL:

https://odin-api.orlog.workers.dev

📚 Available Corpus

Currently serving: havamal Upcoming: Völuspá, Grímnismál, Völsunga saga.

🌍 Supported Languages & Scripts

Ancient Scandinavian Central/West Eastern
elderFuthark norse (Old Norse) english ruski
youngFuthark bokmal / nynorsk deutsch
dansk / svenska spanish
islenska french

🔧 API Endpoints

All requests follow the pattern: /{book}/{language}/{action}

Click any section to expand it.

1. Get Random Stanza
GET /{book}/{language}/random

GET /havamal/english/random
2. Get All Stanzas
GET /{book}/{language}/all

GET /havamal/spanish/all
3. Specific Stanza by ID
GET /{book}/{language}/stanza/{id}

GET /havamal/norse/stanza/12
4. Search by Keyword
GET /{book}/{language}/search?word={query}

GET /havamal/english/search?word=odin
5. Range of Stanzas
GET /{book}/{language}/from/{id}/to/{id}

GET /havamal/bokmal/from/1/to/5

🧱 Response Format

Current legacy format (v1):

[
  "Stanza text here...",
  "Stanza 12"
]

Note

Future versions will migrate to a richer object format containing metadata like source and translator.


🤝 Contributing & Support

Any help is welcome! Whether you found a typo in a translation or want to add a new language:

🛠️ How to contribute:

  1. Reporting Errors: Please Open an Issue describing the bug or the typo.
  2. Adding Languages/Features: - Fork the repository.
  • Create a new branch (git checkout -b feature/new-language).
  • Commit your changes.
  • Open a Pull Request explaining your contribution.

🌐 Translation Support

If you are a linguist or native speaker and want to help us include more texts in your language, please reach out via Issues!


🚀 Performance & Tech

  • Zero Cold Starts: Powered by V8 isolates.
  • Edge Computing: Deployed globally via Cloudflare Workers.
  • Lightweight: Minimal overhead for maximum speed.

📜 License

Code: MIT.

Content: Textual content follows the licensing of each respective translation source.

About

ODIN API is a lightweight, high‑performance Cloudflare Worker that exposes structured access to Norse literary texts. Designed for developers, linguists, and researchers, it delivers stanzas in multiple languages and writing systems through a simple, fast, globally distributed API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published