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.
Ask me anything...
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.
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.
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"]
});
{
"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
}
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.