apiverve / fortuneteller
Fortune Teller uses AI to generate personalized mystical fortunes across multiple categories including love, career, health, wealth, and travel.
Requires
- php: >=7.4
- guzzlehttp/guzzle: ^7.0
Requires (Dev)
- phpunit/phpunit: ^9.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Fortune Teller uses AI to generate personalized mystical fortunes across multiple categories including love, career, health, wealth, and travel.
The Fortune Teller API provides a simple, reliable way to integrate fortune teller functionality into your applications. Built for developers who need production-ready fortune teller capabilities without the complexity of building from scratch.
Quick Start
Using JavaScript
async function callFortuneTellerAPI() { try { const params = new URLSearchParams({ category: 'general', question: 'What does the future hold for me?' }); const response = await fetch(`https://api.apiverve.com/v1/fortuneteller?${params}`, { method: 'GET', headers: { 'x-api-key': 'YOUR_API_KEY_HERE' } }); const data = await response.json(); console.log(data); } catch (error) { console.error('Error:', error); } } callFortuneTellerAPI();
Using cURL
curl -X GET "https://api.apiverve.com/v1/fortuneteller?category=general&question=What%20does%20the%20future%20hold%20for%20me%3F" \ -H "x-api-key: YOUR_API_KEY_HERE"
Get your API key: https://apiverve.com
📁 For more examples, see the examples folder
Installation
Choose your preferred programming language:
📦 NPM (JavaScript/Node.js)
npm install @apiverve/fortuneteller
View NPM Package → | Package Code →
🔷 NuGet (.NET/C#)
dotnet add package APIVerve.API.FortuneTeller
View NuGet Package → | Package Code →
🐍 Python (PyPI)
pip install apiverve-fortuneteller
View PyPI Package → | Package Code →
💎 Ruby (RubyGems)
gem install apiverve_fortuneteller
View RubyGems Package → | Package Code →
🐘 PHP (Packagist)
composer require apiverve/fortuneteller
View Packagist Package → | Package Code →
🎯 Dart (pub.dev)
dart pub add apiverve_fortuneteller
View pub.dev Package → | Package Code →
🤖 Android (JitPack)
implementation 'com.github.apiverve:fortuneteller-api:1.0.0'
🐹 Go
go get github.com/apiverve/fortuneteller-api/go
Why Use This API?
| Feature | Benefit |
|---|---|
| Multi-language SDKs | Native packages for JavaScript, Python, C#, Go, and Android |
| Simple Integration | Single API key authentication, consistent response format |
| Production Ready | 99.9% uptime SLA, served from 24 global regions |
| Comprehensive Docs | Full examples, OpenAPI spec, and dedicated support |
Documentation
- 🏠 API Home: Fortune Teller API
- 📚 API Reference: docs.apiverve.com/ref/fortuneteller
- 📖 OpenAPI Spec: openapi.yaml
- 💡 Examples: examples/
What Can You Build?
The Fortune Teller API is commonly used for:
- Web Applications - Add fortune teller features to your frontend or backend
- Mobile Apps - Native SDKs for Android development
- Automation - Integrate with n8n, Zapier, or custom workflows
- SaaS Products - Enhance your product with fortune teller capabilities
- Data Pipelines - Process and analyze data at scale
API Reference
Authentication
All requests require an API key in the header:
x-api-key: YOUR_API_KEY_HERE
Get your API key: https://apiverve.com
Response Format
Every APIVerve endpoint returns the same envelope — check status, then read data:
{
"status": "ok",
"error": null,
"data": { ... }
}
Example Response
A real response from the Fortune Teller API:
{
"status": "ok",
"error": null,
"data": {
"fortune": "The threads of destiny are weaving a tapestry of unexpected joy; embrace the unknown, for within its depths lie blossoms of serendipity. A golden opportunity awaits, carried upon the wings of synchronicity.",
"insight": "Trust in the whispers of your intuition; it shall guide you through the maze of life.",
"timeframe": "in the coming weeks",
"category": "general",
"question": null,
"luckyNumbers": [
87,
10,
16,
83,
99,
34
],
"luckyElement": "Wood",
"luckyColor": "Purple",
"luckyDay": "Tuesday",
"timestamp": "2025-12-16T22:23:31.796Z"
}
}
Support & Community
- 🏠 API Home: Fortune Teller API
- 💬 Support: https://apiverve.com/contact
- 🐛 Issues: GitHub Issues
- 📖 Documentation: https://docs.apiverve.com
- 🌐 Website: https://apiverve.com
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Security
For security concerns, please review our Security Policy.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
Built with ❤️ by APIVerve
Copyright © 2026 APIVerve. All rights reserved.