Zodiacal

The Zodiac API


Documentation

Welcome to Zodiacal! This API is a collection of traits based on the Sun, Ascendant or Moon. It describes the physical appearance and mental traits of Sun signs and other types of signs. It also describes the element of each zodiac sign and its cardinality. Most of the content of this API is based on This wikihow article.



Details

The API returns JSON.


Note: Assume the prefix 'https://zodiacal.herokuapp.com' for each of the paths mentioned below.


Sun signs (/api)

Returns all 12 sun signs containing: physical_traits, mental_traits, element, cardinality, start and end date of the sign, a list of compatible signs for the sign, the vibe of the sign, symbol, keywords, favorites, good_traits, bad_traits, hates, secret_wish, how_to_spot, and famous_people.

To access a specific sun sign, use the route '/:sign-name' for example, to get Sun in Taurus, use '/taurus'


Rising signs(/rising)

returns all 12 rising signs containing: rising_physical( physical traits) and rising_contents(mental traits). To access a specific rising sign, use the route '/rising/:sign-name', for example, to get Leo rising, use '/rising/leo'


Moon signs (/moon)

Returns all 12 moon signs each containing name and moon_contents(emotional traits). To access a specific moon sign, use the route '/moon/:moon-sign', for example, to get moon in Cancer, use '/moon/cancer'


Elements (/elements)

Returns all 4 elements. To access a specific element, use the route '/elements/:element-name', for example, to get fire element, use '/elements/fire'. Each element contains an array of the signs that fall under that element, and a description for that element.


Cardinalities ('/cardinalities')

Returns all 3 cardinalities. To access a specific cardinality(modality) use the route '/cardinalities/:cardinality-name', for example, to get fixed cardinality, use '/cardinalities/fixed'.Each cardinality contains an array of the signs that fall under that cardinality and a description for each cardinality.


FAQ

How to make sense of the data? This article explains most of the fundamentals of Zodiac.


Is this western or eastern zodiac? It is western zodiac.


Don't know what ascendant is? Look here


Need birth chart? Look here


Other references

AstroStyle

Ranker.com - Zodiac compatibility

MyAstroBlog - Physical ascentant features

HarpersBazaar - Moon signs


If you build something cool with this API, I'd love to see it! Just shoot me an email: arjunkhode [at] gmail