astro.com APIastro.com ↗
Access zodiac sign characteristics, real-time planetary positions, current astrological aspects, and weekly horoscopes from Astro.com via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/c900e9ec-5bb2-4ac8-9ad8-c5d8eba88f2e/get_sign_characteristics?sign=Leo' \ -H 'X-API-Key: $PARSE_API_KEY'
Get comprehensive zodiac sign characteristics including personality traits, strengths, weaknesses, and compatibility information.
| Param | Type | Description |
|---|---|---|
| signrequired | string | Zodiac sign name. Accepted values: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces. |
{
"type": "object",
"fields": {
"sign": "string - capitalized zodiac sign name",
"traits": "object - additional structured traits (may be empty)",
"summary": "string - brief meta description of the sign",
"characteristics": "array of strings - paragraphs describing personality traits"
},
"sample": {
"data": {
"sign": "Aries",
"traits": {},
"summary": "You need a cause, a mission, a battle in which you can trounce the enemy. The slightest whiff of a challenge and out comes that old suit of armour, kept clean and polished in case of emergency. Passionate conviction, courage, bravery, vision, a touch of fanaticism - all these things belong to the Aries soul.",
"characteristics": [
"You need a cause, a mission, a battle in which you can trounce the enemy..."
]
},
"status": "success"
}
}About the astro.com API
This API exposes 4 endpoints covering astrological data sourced from Astro.com, including real-time planetary positions with degree, sign, arc minutes, and declination for each celestial body. The get_sign_characteristics endpoint returns multi-paragraph personality descriptions, strengths, weaknesses, and compatibility notes for all 12 zodiac signs. The get_general_horoscope endpoint delivers the current weekly tendencies text as a structured array of content paragraphs.
Zodiac Sign Characteristics
The get_sign_characteristics endpoint accepts a sign parameter (e.g., Aries, Taurus, Scorpio) and returns a characteristics array of descriptive paragraphs, a summary string pulled from the sign's meta description, and a traits object for any structured trait data available. This covers all 12 standard Western zodiac signs.
Planetary Positions and Aspects
get_planetary_positions requires no inputs and returns a planets array where each object includes body (the celestial body name), degree, sign, minutes (arc minutes), and declination. Data reflects current real-time positions. The get_aspects endpoint also takes no inputs and returns an aspects array alongside a message string summarizing active celestial events. Note that get_aspects may return an empty aspects array when no notable aspect data is available, with context provided only through the message field.
Weekly Horoscope
get_general_horoscope returns a title string and a content array of strings representing the weekly forecast paragraphs. Content is filtered to lines longer than 50 characters, so very short transitional lines are excluded from the response. This endpoint reflects the general (non-sign-specific) weekly tendencies published on Astro.com and updates on a weekly cycle.
Coverage Notes
All four endpoints cover publicly available astrological content. There are no input filters for date ranges or geographic coordinates — positions and horoscopes represent current or current-week values only.
- Display real-time planetary positions with degree and sign data in an astronomy or astrology dashboard
- Populate zodiac sign profile pages with multi-paragraph personality traits and compatibility notes from
get_sign_characteristics - Deliver a weekly horoscope digest to app users using the
contentarray fromget_general_horoscope - Build a daily celestial event summary widget using the
messagefield fromget_aspects - Generate zodiac-based matchmaking features using the
traitsandcharacteristicsfields - Provide sign-specific onboarding copy in wellness or journaling apps by querying individual zodiac signs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Astro.com provide an official developer API?+
What does `get_planetary_positions` actually return for each celestial body?+
planets array includes five fields: body (the name of the celestial body), degree (position in degrees within its sign), sign (the zodiac sign it occupies), minutes (arc minutes for precision), and declination. The endpoint takes no inputs and always reflects current positions.Can I retrieve horoscopes for a specific zodiac sign rather than the general weekly forecast?+
get_general_horoscope, which is not sign-specific. Sign-specific forecasts are not included. You can fork this API on Parse and revise it to add a sign-specific horoscope endpoint.Is historical planetary position data available, or can I query positions for a specific date?+
get_planetary_positions returns current real-time data only — there is no date parameter for historical or future ephemeris queries. You can fork this API on Parse and revise it to add a date-based planetary position endpoint.What happens when `get_aspects` returns an empty aspects array?+
aspects array will be empty and the message string carries the summary of current celestial events. Applications should handle the empty-array case and fall back to rendering the message field.