Literary Vault Question Repository

Access questions by category for API integration.

Categories

API Access

Use the following curl commands to access the CSV files:


curl -X GET "https://exios66.github.io/LITERARY-API-HOST/docs/data/Astronomy-questions.csv" -o "Astronomy-Questions.csv"
curl -X GET "https://exios66.github.io/LITERARY-API-HOST/docs/data/Literature-questions.csv" -o "Literature-Questions.csv" 
curl -X GET "https://exios66.github.io/LITERARY-API-HOST/docs/data/Mathematics-questions.csv" -o "Mathematics-Questions.csv"
curl -X GET "https://exios66.github.io/LITERARY-API-HOST/docs/data/General-Knowledge-questions.csv" -o "General-Knowledge-Questions.csv"
curl -X GET "https://exios66.github.io/LITERARY-API-HOST/docs/data/Psychology-questions.csv" -o "Psychology-Questions.csv"
curl -X GET "https://exios66.github.io/LITERARY-API-HOST/docs/data/American-History-questions.csv" -o "american-history-questions.csv"

Sample Questions

Below is a sample set of questions formatted in a tabular markdown:

ID Question Correct Answer Choice 1 Choice 2 Choice 3 Difficulty Knowledge Category Topic Focus
521 Who wrote 'Hamlet'? William Shakespeare Jane Austen Charles Dickens George Orwell 0 Literature Authors & Literature
522 Who is the author of 'Pride and Prejudice'? Jane Austen Emily Bronte Mary Shelley Virginia Woolf 1 Literature Authors & Literature
523 Who wrote 'The Great Gatsby'? F. Scott Fitzgerald Ernest Hemingway John Steinbeck Mark Twain 2 Literature Authors & Literature
524 Who authored 'One Hundred Years of Solitude'? Gabriel Garcia Marquez Isabel Allende Mario Vargas Llosa Julio Cortazar 3 Literature Authors & Literature

Action JSON Framework


{
  "name": "get_questions",
  "description": "Retrieves questions from the CSV files in the Literary Vault repository",
  "parameters": {
    "type": "object", 
    "properties": {
      "category": {
        "type": "string",
        "description": "The category of questions to retrieve",
        "enum": ["Astronomy", "Literature", "Mathematics"]
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of questions to return",
        "default": 10,
        "minimum": 1,
        "maximum": 50
      },
      "difficulty": {
        "type": "integer",
        "description": "Difficulty level of questions (0-3)",
        "minimum": 0,
        "maximum": 3,
        "default": null
      },
      "topic": {
        "type": "string",
        "description": "Specific topic focus to filter by",
        "default": null
      },
      "random": {
        "type": "boolean",
        "description": "Whether to return random questions or sequential ones",
        "default": true
      }
    },
    "required": ["category"]
  },
  "returns": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the question"
        },
        "question": {
          "type": "string", 
          "description": "The question text"
        },
        "correct_answer": {
          "type": "string",
          "description": "The correct answer"
        },
        "choices": {
          "type": "array",
          "description": "Array of multiple choice options",
          "items": {
            "type": "string"
          },
          "minItems": 3,
          "maxItems": 3
        },
        "difficulty": {
          "type": "integer",
          "description": "Difficulty level (0-3)"
        },
        "knowledge_category": {
          "type": "string",
          "description": "Main category (Astronomy, Literature, Mathematics)"
        },
        "topic_focus": {
          "type": "string",
          "description": "Specific topic within the category"
        }
      },
      "required": ["id", "question", "correct_answer", "choices", "difficulty", "knowledge_category", "topic_focus"]
    }
  }
}

API Documentation & Sitemap

API Usage Examples

Access questions programmatically using the following methods:

1. Direct CSV Access


# Python Example
import pandas as pd
url = "https://exios66.github.io/LITERARY-API-HOST/docs/data/Astronomy-questions.csv"
df = pd.read_csv(url)

2. JavaScript API Client


const api = new LiteraryVaultAPI();
const result = await api.getQuestions('astronomy', {
    limit: 5,
    random: true,
    difficulty: 2
});

3. Markdown Format


const router = new QuestionRouter();
const result = await router.handleRequest({
    category: 'astronomy',
    limit: 5,
    random: true,
    format: 'markdown'
});

API Documentation & Sitemap

Integration Examples