Fortune Teller API Documentation

📖 Overview

The Fortune Teller API provides random fortune predictions in multiple languages. With 52 unique fortunes covering various life aspects, it's perfect for entertainment apps, daily motivation services, or cultural applications.

🌍 Multilingual Support

Thai, Chinese (Simplified), and English language options

🎯 52 Unique Fortunes

Carefully curated predictions covering all aspects of life

📚 5 Life Categories

Love, Career, Health, Finance, and General life advice

🎲 Random Selection

Cryptographically secure random fortune selection

🌍 Supported Languages

🇹🇭 Thai

ภาษาไทย (th)

🇨🇳 Chinese

简体中文 (zh)

🇺🇸 English

English (en)

📋 Fortune Categories

💕 Love & Relationships

Romance, relationships, marriage

💼 Career & Work

Job prospects, business success

🏥 Health & Wellness

Physical and mental health

💰 Finance & Wealth

Money, investments, prosperity

🌟 General Life

Overall luck and life guidance

🌐 Base URL

https://api.lorwongam.com/api/fortune-teller/

🔐 Authentication

No authentication required. This is a public API that can be accessed without any API keys or tokens.

📡 API Endpoints

GET / Get Random Fortune

Retrieve a random fortune prediction in the specified language.

Parameters

This endpoint doesn't require any parameters. It returns a random fortune from the collection of 52 fortunes, with predictions in all three languages (Thai, Chinese, and English).

Example Request - Get Random Fortune

curl "https://api.lorwongam.com/api/fortune-teller/"

Example Request - POST Method

curl -X POST "https://api.lorwongam.com/api/fortune-teller/"

POST / Get Random Fortune (Alternative)

Alternative POST method for getting fortune predictions with JSON request body.

Request Parameters

Parameter	Type	Required	Default	Description
`lang`	string	Optional	"en"	Language code: "th", "zh", or "en"
`id`	integer	Optional	random	Specific fortune ID (1-52)

Example POST Request

curl -X POST "https://api.lorwongam.com/api/fortune-teller/" \
  -H "Content-Type: application/json" \
  -d '{
    "lang": "th"
  }'
                    

📊 Response Format

Success Response

English Fortune Example

{
  "success": true,
  "data": {
    "id": 7,
    "fortune": "Today brings unexpected opportunities. Trust your instincts when making important decisions, as they will guide you toward success.",
    "category": "general",
    "language": "en",
    "language_name": "English"
  },
  "message": "Fortune retrieved successfully",
  "timestamp": "2025-09-09T12:00:00Z"
}
                    

Thai Fortune Example

{
  "success": true,
  "data": {
    "id": 15,
    "fortune": "ความรักที่แท้จริงกำลังจะมาถึง อดทนรอคอยและเปิดใจให้กับคนใหม่ที่เข้ามาในชีวิต",
    "category": "love",
    "language": "th",
    "language_name": "Thai"
  },
  "message": "Fortune retrieved successfully",
  "timestamp": "2025-09-09T12:00:00Z"
}
                    

Chinese Fortune Example

{
  "success": true,
  "data": {
    "id": 23,
    "fortune": "事业运势渐入佳境，与同事合作将带来意想不到的成果，把握机会展现自己的才华。",
    "category": "career",
    "language": "zh",
    "language_name": "Chinese"
  },
  "message": "Fortune retrieved successfully",
  "timestamp": "2025-09-09T12:00:00Z"
}
                    

Error Response

{
  "success": false,
  "error": "Invalid language code. Supported languages: th, zh, en",
  "code": "INVALID_LANGUAGE",
  "timestamp": "2025-09-09T12:00:00Z"
}
                    

🎯 Fortune Categories

Category	Description	Example Topics
`love`	Love and relationships	Romance, marriage, soulmates, heartbreak recovery
`career`	Career and professional life	Job opportunities, promotions, business ventures
`health`	Health and wellness	Physical health, mental wellness, lifestyle changes
`finance`	Money and financial matters	Investments, savings, financial planning, prosperity
`general`	General life guidance	Overall luck, life decisions, personal growth

⚠️ Error Codes

Code	Description
`INVALID_LANGUAGE`	Language code is not supported
`INVALID_ID`	Fortune ID is outside the valid range (1-52)
`FORTUNE_NOT_FOUND`	Specified fortune ID does not exist
`FILE_ERROR`	Error reading fortune data files

🔗 Integration Examples

JavaScript/AJAX

fetch('https://api.lorwongam.com/api/fortune-teller/?lang=en')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('Fortune:', data.data.fortune);
      console.log('Category:', data.data.category);
    }
  });
                

PHP

$response = file_get_contents('https://api.lorwongam.com/api/fortune-teller/?lang=th');
$data = json_decode($response, true);

if ($data['success']) {
    echo "Fortune: " . $data['data']['fortune'];
    echo "Category: " . $data['data']['category'];
}
                

Python

import requests

response = requests.get('https://api.lorwongam.com/api/fortune-teller/?lang=zh')
data = response.json()

if data['success']:
    print(f"Fortune: {data['data']['fortune']}")
    print(f"Category: {data['data']['category']}")
                

🚦 Rate Limits

Currently, there are no rate limits imposed on this API. However, please use it responsibly and avoid excessive requests that might impact service availability for other users.

🏛️ Cultural Considerations

Respectful Content: All fortunes are designed to be positive and respectful across cultures
Cultural Sensitivity: Translations maintain cultural context appropriate for each language
Entertainment Purpose: This API is designed for entertainment and should not be used for serious life decisions
Diverse Perspectives: Fortunes cover universal human experiences across different cultures

🔮 Fortune Teller API