The palm reading engine for modern apps.
Upload one palm photo and receive structured hand features, line analysis, life-aspect readings, and an optional processed palm overlay.
What is palmistry?
Palmistry, also called chiromancy, is the practice of reading the palm to understand character, tendencies, and life patterns. A palm reader studies hand shape, major lines like the Heart, Head, Life, and Fate lines, minor lines, mounts, and special markings to interpret emotional nature, thinking style, vitality, career direction, relationships, strengths, and personal growth themes. It has roots in Indian, Chinese, Greek, and Roman traditions and is best used for entertainment, reflection, and self-discovery.
READING CATEGORIES
8 palmistry categories included.
Generate focused readings from one palm scan across personality, career, money, relationships, health, challenges, and luck indicators.
PALM PREDICTION FLOW
Get palm predictions step by step.
Guide users from palm capture to structured readings and processed palm overlays with a clear product flow.
01
Scan the palm image
02
Call the structured JSON response
03
Call category readings for use cases
04
Show processed palm images
1curl --request POST \
2 --url https://json.astrologyapi.com/v1/get-palm-id \
3 --header 'x-astrologyapi-key: YOUR_API_KEY' \
4 --header 'Content-Type: application/json' \
5 --data '{
6 "image_url": "https://example.com/palm.jpg"
7 }'CAPABILITIES
Complete palm analysis.
Everything you need to add professional palmistry to your app.
Add palmistry without building vision infrastructure.
Use the palmistry route for your CTAs now, then connect the full developer docs when the section is ready.
Frequently Asked Questions
The Palmistry API uses AI vision models to analyze a palm image and generate structured palm features along with detailed readings about personality, career, finances, relationships, health, and other life aspects. Responses are returned as easy-to-use JSON.
For the best results, upload a clear, well-lit image of a single palm in JPG/JPEG and PNG format. Images should be under 5 MB for palm reading and should clearly show the major palm lines.
The API generates readings for Personality, Career, Money, Love, Marriage, Health, Challenges, and Luck. It also extracts detailed palm features such as hand type, major lines, minor lines, mounts, and special markings.
Yes. The Processed Palm endpoint detects major palm lines using a computer vision model and returns an image with colored overlays showing the detected Heart, Head, Life, and Fate lines along with confidence scores.
First, upload a palm image to receive a unique palm_id. Once the scan is complete, you can retrieve palm features, category-specific readings, or the processed palm image using that ID without re-uploading the image.
Yes. The API is designed for developers, startups, and businesses building astrology platforms, palm reading apps, wellness products, AI assistants, entertainment applications, and spiritual services.
No. The API follows traditional palmistry principles enhanced by AI image analysis. The readings are intended for entertainment, personal reflection, and user engagement, and should not be considered scientific, legal, financial, or medical advice.
Yes. The API follows standard REST conventions, supports secure authentication, and returns structured JSON responses that work with virtually any programming language or framework, including JavaScript, Python, PHP, Java, .NET, and mobile platforms.