🌍 Astrocartography API, 🔷 Human Design API and ✋ Palmistry API are now live. Ship them in your app today.

Love Reading

Generates a love reading from the stored face-reading features.
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

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."
  }
}