šŸ•°ļø 15+ Muhurta APIs and āœ‹ Palmistry API are now live. Ship them in your app today.

Love Reading

You must provide a valid face_id to call this API. How to get Face ID ā†’
Love Reading API interprets the facial features from the perspective of romance, emotional openness, affection, attraction, and bonding style. It can draw from areas such as the eyes, mouth, lips, eyebrows, and other relationship-related facial indicators.

The response can include `romantic_nature`, `emotional_expression`, `attraction_style`, `giving_vs_receiving`, `relationship_patterns`, `advice`, and a final `summary`.

This creates a focused romantic profile while keeping its interpretation linked to the observations already stored under the face_id.
POSThttps://vision.astrologyapi.com/face-reading/love

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Body parameters

face_idstringrequired

Unique face reading ID returned by get-face-id

Get a love category reading for a previously scanned face.
ā† Previous
Health Reading
Next ā†’
Luck Reading
curl --location 'https://vision.astrologyapi.com/face-reading/love' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "face_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
}'
Try it

Runs with sample data ā€” no API key needed

{
  "status": true,
  "data": {
    "romantic_nature": "With almond-shaped eyes and a calm Shen, their love is steady and observant, favoring a deep, soulful connection over fleeting passion. The full lower lip suggests a rich, sensual capacity for love that is deeply felt and nurturing.",
    "emotional_expression": "The smooth area under the eyes indicates a natural emotional tenderness and a heart that is easily touched. While the neutral mouth corners suggest a composed exterior, their affection is expressed through consistent, gentle presence rather than grand gestures.",
    "attraction_style": "They attract others through a sense of stability and quiet confidence, mirrored in their neat, straight eyebrows. They are drawn to partners who appreciate their observant nature and the serene energy they radiate.",
    "giving_vs_receiving": "The balance between a balanced upper lip and a fuller lower lip indicates a generous spirit; they are more inclined to give affection and emotional support than to demand it, finding joy in the act of nurturing their partner.",
    "relationship_patterns": "Their straight, flowing eyebrows suggest a direct and honest approach to romance, avoiding games in favor of clarity. They tend to build relationships on a foundation of mutual respect and emotional equilibrium.",
    "advice": "Allow your observant nature to transition into open communication; by sharing the insights you quietly gather, you can bring even more intimacy to your bond.",
    "summary": "A gentle and nurturing romantic whose love is characterized by emotional tenderness and a generous heart. They offer a calming, stable presence that fosters deep trust and sensual harmony."
  }
}