horoscopes.astro-seek.com APIhoroscopes.astro-seek.com ↗
Fetch real-time planetary positions, natal chart calculations with house cusps and aspects, and transit aspects from Astro-Seek via a clean REST API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d34d9ecb-49e0-4bc5-916f-8ef8807a6b84/current_positions' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract all current planetary positions including zodiac signs, degrees, and retrograde status. Returns real-time positions for Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Lunar Nodes, Lilith, and Chiron.
No input parameters required.
{
"type": "object",
"fields": {
"current_positions": "array of objects with planet, sign, degree, sign_abbr, is_retrograde"
},
"sample": {
"data": {
"current_positions": [
{
"sign": "Taurus",
"degree": "23° 52'",
"planet": "Sun",
"sign_abbr": "Tau",
"is_retrograde": false
},
{
"sign": "Aries",
"degree": "23° 40'",
"planet": "Moon",
"sign_abbr": "Ari",
"is_retrograde": false
},
{
"sign": "Aquarius",
"degree": "5° 29'",
"planet": "Pluto",
"sign_abbr": "Aqu",
"is_retrograde": true
}
]
},
"status": "success"
}
}About the horoscopes.astro-seek.com API
The Astro-Seek Horoscopes API exposes 3 endpoints covering real-time planetary positions, full natal chart calculations, and personalized transit aspects. The current_positions endpoint returns live zodiac placements for 14 celestial bodies including retrograde status, while natal_chart and transits accept birth date, city, and time parameters to produce house cusps, aspect tables, and interpretations.
Endpoints and Data Coverage
The current_positions endpoint requires no inputs and returns an array of objects for 14 celestial bodies — Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Lunar Nodes, Lilith, and Chiron. Each object includes the planet name, zodiac sign, degree within that sign, abbreviated sign name, and a boolean is_retrograde flag. No parameters are needed; the data reflects positions at the time of the request.
Natal Chart Calculation
The natal_chart endpoint accepts a birth date (day, month, year), a city string for location, and optional hour and minute for time precision. The response includes three main arrays: planets (sign, degree, house placement, and retrograde status for each body), houses (cusp sign and degree for all 12 houses), and aspects (planet pairs with aspect type, orb in degrees, and major/minor classification). An interpretations array provides text entries with title and content fields, and chart_image_url returns a URL to a rendered chart graphic when available.
Transit Aspects
The transits endpoint maps current or specified transiting planets against a natal chart. It shares the same birth-date and city inputs as natal_chart but adds optional transit_day, transit_month, and transit_year parameters; omitting them defaults to the current UTC date. Birth time is set to noon for transit calculations. The response includes a summary string, the resolved transit_date in YYYY-M-D format, and a transit_aspects array where each entry records the transiting planet and its sign, the aspect type, the natal planet and its sign, and the orb.
Notes on Coverage
City-based geocoding is handled internally, so the city input should be an unambiguous place name (e.g., "London" rather than an abbreviation). The chart_image_url field can be null if no image is generated for a given calculation. Aspect orbs are returned as numeric values but aspect interpretation is not included in the transits endpoint — only the natal_chart endpoint provides the interpretations array.
- Display a daily planetary ephemeris widget showing retrograde status for all major bodies using
current_positions. - Generate natal chart reports for users who provide their birth date, city, and time, surfacing house placements and aspect tables.
- Build a transit calendar that highlights significant planet-to-natal-planet aspects for a given date range using the
transitsendpoint. - Flag Mercury, Mars, or other retrograde planets in a mobile astrology app using the
is_retrogradefield fromcurrent_positions. - Calculate and display Ascendant and Midheaven signs from the
housesarray in a natal chart form. - Compare natal aspect patterns (major vs. minor aspect types) across multiple birth charts for research or compatibility tools.
- Populate a personalized horoscope feed by pairing transit aspects with the natal planet and sign fields.
| 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-Seek have an official developer API?+
What does the `natal_chart` endpoint return beyond planet positions?+
planets array with sign, degree, house, and retrograde status, the response includes a houses array of 12 house cusps (sign and degree), an aspects array with orb and type for each planet pair, an interpretations array with titled text content, and a chart_image_url string that links to a rendered chart image (or null if unavailable).How precise are transit calculations when birth time is not known?+
transits endpoint uses noon as the birth time when no birth hour or minute is provided. House-sensitive transit aspects (those involving house cusps or the Ascendant) will be less accurate without a precise birth time. The natal_chart endpoint accepts optional hour and minute inputs for greater precision.Does the API return solar return or synastry charts?+
Are asteroid positions other than Chiron and Lilith available?+
current_positions and natal_chart cover the traditional planets plus Lunar Nodes, Lilith, and Chiron — 14 bodies total. Additional asteroids such as Juno, Pallas, or Vesta are not returned. You can fork this API on Parse and revise it to add coverage for additional asteroids if Astro-Seek exposes them.