Turn one palm photo into a complete palm reading.
Send a photo of a hand. Get back hand type, fingers, major and minor lines, mounts, and readings for love, career, money and health as clean JSON, plus an optional annotated palm image to show your users.
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.
Your data
How we handle palm-reading data
Know what happens to a palm image and its readings before you build them into your application.
What you send
Palm images or image URLs, associated identifiers and the inputs needed for the requested reading. Images, extracted information and readings can form a reusable record.
Storage & deletion
Permanently deleted after approximately thirty days, including originals and backups held by AstrologyAPI. This is an approximate cycle, not a fixed day-thirty deadline.
AI & model use
AstrologyAPI never trains models on user data. Our main AI providers are OpenAI and Gemini, and we prohibit their use of customer data for their own evaluation. Provider-specific retention and processing arrangements are separate from our own storage cycle.
Only upload images you are authorised to provide. Record identifiers and generated readings may still be personal data.
Infrastructure & service providers
We use AWS and Google Cloud infrastructure in India and US regions, Cloudflare for DNS and website hosting, and R2 and S3 storage. These are overall infrastructure details, not exclusive residency commitments for every product, provider or backup. Service-specific arrangements belong in your agreement.
Explore service providersAdd 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.