Gods

Welcome to the documentation for the Greek Myth API endpoint. This endpoint offers comprehensive data on various heroes from Greek mythology, allowing you to seamlessly integrate rich content into your applications.

Endpoint Overview

The Greek Gods endpoint is accessible via:

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

This endpoint retrieves information about gods from Greek mythology, including their names, descriptions, attributes, and associated imagery.

Authentication

Currently, the API does not require authentication, making it easy to start fetching data right away. Simply use the base URL provided in your requests.

Response Structure

The response from the /api/gods endpoint follows this structure:

{
  "Gods": [
    {
      "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
    }
    // More gods...
  ]
}

Accessing the Endpoint

Here are several ways to access the /api/gods endpoint:

Using JavaScript Fetch API

fetch("https://thegreekmythapi.vercel.app/api/gods")
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

Using Axios

import axios from "axios";
 
axios
  .get("https://thegreekmythapi.vercel.app/api/gods")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error("Error:", error);
  });

Using Python with requests

import requests
 
response = requests.get("https://thegreekmythapi.vercel.app/api/gods")
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")

Using cURL

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

Project Examples

Here are some example projects that demonstrate how to use the Greek Gods API:

Greek God of the Day Website

Create a website that displays a different Greek god each day, showcasing their information and image.

// React component example
import React, { useState, useEffect } from "react";
import axios from "axios";
 
function GodOfTheDay() {
  const [god, setGod] = useState(null);
 
  useEffect(() => {
    axios
      .get("https://thegreekmythapi.vercel.app/api/gods")
      .then((response) => {
        const gods = response.data.Gods;
        const randomGod = gods[Math.floor(Math.random() * gods.length)];
        setGod(randomGod);
      })
      .catch((error) => console.error("Error:", error));
  }, []);
 
  if (!god) return <div>Loading...</div>;
 
  return (
    <div>
      <h1>{god.name}</h1>
      <img src={god.image} alt={god.name} />
      <p>{god.description}</p>
      {/* Display more god information */}
    </div>
  );
}

Greek Mythology Quiz Game

Develop a quiz game that tests users' knowledge of Greek gods using the API data.

# Python quiz game example
import requests
import random
 
def fetch_gods():
    response = requests.get("https://thegreekmythapi.vercel.app/api/gods")
    return response.json()['Gods'] if response.status_code == 200 else []
 
def play_quiz():
    gods = fetch_gods()
    score = 0
    total_questions = 5
 
    for _ in range(total_questions):
        god = random.choice(gods)
        print(f"What is {god['name']} the god of?")
        user_answer = input("Your answer: ").lower()
        if user_answer in god['description'].lower():
            print("Correct!")
            score += 1
        else:
            print(f"Incorrect. {god['name']} is {god['description']}")
 
    print(f"You scored {score} out of {total_questions}")
 
play_quiz()

Greek God Family Tree Visualizer

Create a visual representation of the Greek gods' family relationships using a library like D3.js.

// D3.js example (simplified)
import * as d3 from "d3";
 
fetch("https://thegreekmythapi.vercel.app/api/gods")
  .then((response) => response.json())
  .then((data) => {
    const gods = data.Gods;
 
    // Create nodes and links based on family relationships
    const nodes = gods.map((god) => ({ id: god.name }));
    const links = [];
 
    gods.forEach((god) => {
      if (god.attributes.family) {
        god.attributes.family.parents.forEach((parent) => {
          links.push({ source: parent, target: god.name });
        });
      }
    });
 
    // Set up D3 force simulation
    const simulation = d3
      .forceSimulation(nodes)
      .force(
        "link",
        d3.forceLink(links).id((d) => d.id)
      )
      .force("charge", d3.forceManyBody())
      .force("center", d3.forceCenter(width / 2, height / 2));
 
    // Render the nodes and links
    // (Add D3 code to create SVG elements and update their positions)
  });

These project examples demonstrate various ways to utilize the Greek Gods API in web development, game creation, and data visualization contexts.

Docs Heroes