Astro-Seek 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.
What is the Astro-Seek 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace horoscopes-astro-seek-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Astro-Seek Astrology API — planetary positions, natal charts, and transits."""
from parse_apis.astro_seek_astrology_api import AstroSeek, CityNotFound
client = AstroSeek()
# Get current sky state — real-time planetary positions
sky = client.skies.current()
for pos in sky.current_positions[:5]:
print(pos.planet, pos.sign, pos.degree, "R" if pos.is_retrograde else "")
# Calculate a natal chart for a specific birth date/time/city
chart = client.natalcharts.calculate(day=15, month=7, year=1990, city="New York", hour=14, minute=30)
for planet in chart.planets[:3]:
print(planet.planet, planet.sign, planet.house, planet.is_retrograde)
for house in chart.houses[:3]:
print(house.house, house.sign, house.degree)
for aspect in chart.aspects[:3]:
print(aspect.planet1, aspect.aspect, aspect.planet2, aspect.orb)
print("Interpretations:", len(chart.interpretations))
print("Chart image:", chart.chart_image_url)
# Calculate transits for a birth chart on a specific date
try:
report = client.transitreports.calculate(
day=15, month=7, year=1990, city="London",
transit_day=11, transit_month=6, transit_year=2026,
)
print(report.transit_date, report.summary)
for ta in report.transit_aspects[:3]:
print(ta.transit_planet, ta.transit_sign, ta.aspect, ta.natal_planet, ta.orb)
except CityNotFound as exc:
print(f"City not found: {exc.city}")
print("exercised: skies.current / natalcharts.calculate / transitreports.calculate")
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 parameters required — always returns current sky state.
No input parameters required.
{
"type": "object",
"fields": {
"current_positions": "array of PlanetPosition objects with planet, sign, degree, sign_abbr, is_retrograde"
},
"sample": {
"data": {
"current_positions": [
{
"sign": "Gemini",
"degree": "20° 14'",
"planet": "Sun",
"sign_abbr": "Gem",
"is_retrograde": false
},
{
"sign": "Aries",
"degree": "24° 39'",
"planet": "Moon",
"sign_abbr": "Ari",
"is_retrograde": false
},
{
"sign": "Aquarius",
"degree": "5° 13'",
"planet": "Pluto",
"sign_abbr": "Aqu",
"is_retrograde": true
}
]
},
"status": "success"
}
}About the Astro-Seek API
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.
The Astro-Seek API is a managed, monitored endpoint for horoscopes.astro-seek.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when horoscopes.astro-seek.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official horoscopes.astro-seek.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.