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
This package is not auto-updated.
Last update: 2026-07-16 23:56:08 UTC
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.