API Documentation

Greek Myth API Documentation

Welcome to the Greek Mythology API! Access detailed information about gods, heroes, monsters, and titans from ancient Greek and Roman mythology.

Base URL

https://thegreekmythapi.vercel.app/api

Available Endpoints

/gods – Olympian deities and divine beings
/heroes – Legendary warriors and champions
/monsters – Fearsome creatures and beasts
/titans – Primordial gods and giants

Example: Get All Gods

GET https://thegreekmythapi.vercel.app/api/gods

Sample response:

  {
      "name": "Zeus",
      "description": "The king of the gods, the ruler of Mount Olympus, and the god of the sky, lightning, thunder, law, order, and justice.",
      "category": "God",
      "attributes": {
        "origin": "Son of Cronus and Rhea",
        "symbols": [
          "Thunderbolt",
          "Eagle",
          "Oak"
        ],
        "abode": "Mount Olympus",
        "powers": [
          "Control over the weather",
          "Ability to hurl thunderbolts"
        ],
        "family": {
          "parents": [
            "Cronus",
            "Rhea"
          ],
          "siblings": [
            "Hades",
            "Poseidon",
            "Hestia",
            "Demeter"
          ],
          "spouse": [
            "Hera"
          ]
        },
        "stories": [
          "Defeat of the Titans",
          "The Birth of Hercules"
        ]
      },
      "image": "/images/zeus.png",
      "id": 1
    }

Other Endpoints

/heroes – GET all heroes
```
GET /api/heroes
```
/monsters – GET all monsters
```
GET /api/monsters
```
/titans – GET all titans
```
GET /api/titans
```

Usage

No authentication required. Simply send a GET request to any endpoint. Example using fetch in JavaScript:

fetch('https://thegreekmythapi.vercel.app/api/gods')
  .then(res => res.json())
  .then(data => console.log(data))