8Ball API: Magic 8-Ball Fortune Telling

Add mystical fortune telling to your apps with our RESTful API. Integrate seamlessly with Discord bots, games, web apps, and more. Simple, reliable, and ready to use in minutes.

No API Key Required
Multiple Languages
Free to Use

Ask me anything...

Real-World Examples

How Developers Are Using 8Ball API

Our fortune-telling API serves hundreds of thousands of requests for developers across the globe. Here's how developers are integrating it today.

Discord & Chat Bots

Power your chat bots with fortune-telling capabilities in seconds. With just one API call, create entertaining commands like /8ball that keep users engaged and coming back. Supports multiple languages for global communities.

Game Integrations

Add randomized fortune-telling elements to your games with our sentiment-based responses. Create mysterious NPCs, fortune tellers, or decision-making mechanics. The biased response feature analyzes question sentiment for contextually appropriate answers.

Creative Applications

From decision-making tools to writing prompts, our API enables creative applications of all kinds. Perfect for educational projects teaching API concepts, interactive storytelling, and innovative tools. Simple enough for beginners, powerful enough for production apps.

Documentation

Simple to implement, powerful to use

Our API is RESTful and returns JSON, making it easy to integrate with any application.

GET /api

Returns a plain text Magic 8-Ball response.

GET /api/categories

Returns all responses grouped by category (positive, negative, neutral).

POST /api/biased

Returns a biased response based on the sentiment of the question.

Example Request
fetch('https://eightballapi.com/api/biased?question=Will+I+succeed&lucky=true')
.then(response => response.json())
.then(data => {
  console.log(data.reading); // "Outlook good"
  console.log(data.sentiment.score); // 2
  console.log(data.sentiment.positive); // ["succeed"]
});
Response:
{
  "reading": "Outlook good",
  "question": "Will I succeed?",
  "sentiment": {
    "score": 2,
    "comparative": 0.6667,
    "calculation": [{"succeed": 2}],
    "tokens": ["Will", "I", "succeed?"],
    "words": ["succeed"],
    "positive": ["succeed"],
    "negative": []
  },
  "locale": "en",
  "lucky": true
}
Get Started Today

Add fortune telling to your app today

Our API is free to use, requires no API key, and supports multiple languages. Start integrating fortune telling into your applications in minutes.

Quick Start

1. Make a simple API call
GET https://eightballapi.com/api
2. Get your fortune
"It is decidedly so."
3. Add parameters for more control
GET https://eightballapi.com/api/positive?locale=fr