By topic / Face Reading API
Face Reading API: Samudrika Shastra from one photo
Read the face shape, eyes, nose, mouth and more, and themes such as career and family, in the tradition of Samudrika Shastra. It never names anyone, and never infers race, religion, caste or a health condition. The person in the photo must have agreed, and we do not store it.
What people build with it
- A face reading feature
- Entertainment and reflection apps
The endpoints
- Whole Face Reading
Every section of a face reading from one photo, for the price of one call. It never names anyone, or infers race, religion or health conditions.
POST /v1/face-reading/face-reading
Metered, from 15 credits
- Face: Face Shape
The face shape and the balance of its zones. Read from one photo of the face by a vision model; the photo is not stored.
POST /v1/face-reading/face-shape
Metered, from 15 credits
- Face: Eyes
Eye shape, spacing and brows. Read from one photo of the face by a vision model; the photo is not stored.
POST /v1/face-reading/face-eyes
Metered, from 15 credits
- Face: Personality
Character and temperament. Read from one photo of the face by a vision model; the photo is not stored.
POST /v1/face-reading/face-personality
Metered, from 15 credits
- Face: Career
Work and calling. Read from one photo of the face by a vision model; the photo is not stored.
POST /v1/face-reading/face-career
Metered, from 15 credits
- Face: Outline Traced
The outline of the face and its features traced on a photo, with an SVG overlay to lay over your copy, and scores for how the face looks in that photo. It never names anyone. The photo is not stored or sent back.
POST /v1/face-reading/face-outline-image
Metered, from 15 credits
Common questions
- What if the photo is unclear?
- The answer says what is wrong and how to retake it, and you are not charged.

