APIHub
Back to Explore

CosmyDay Astrology

A free, no‑key API that returns JSON‑encoded natal chart calculations (planet positions, houses, aspects) based on Swiss Ephemeris, upcoming sky‑event timelines (retrogrades, lunations, eclipses, etc.), and daily/weekly/monthly horoscope content, plus a geocoding helper for location coordinates.

Entertainment
none
HTTPS
CORS: Yes
Description enriched
Visit official documentation

Latency

525ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/health

Service health

POST

/natal

Calculate a natal chart

GET

/events/upcoming

Upcoming sky events

  • days (query) — How far ahead to look
  • limit (query, limit)
  • min_importance (query) — 60 and above is roughly 'notable'
  • kind (query) — Restrict to one kind; see /events/kinds
  • from_date (query) — Override today, as YYYY-MM-DD
GET

/events/kinds

Event kinds with counts

GET

/content/daily

Daily horoscopes, all twelve signs

GET

/content/daily/{sign}

Daily horoscope for one sign

GET

/content/weekly

Weekly horoscopes, all signs

GET

/content/weekly/{sign}

Weekly horoscope for one sign

GET

/content/monthly

Monthly horoscopes, all signs

GET

/content/monthly/{sign}

Monthly horoscope for one sign

GET

/content/monthly-archive/list

Every archived sign-month available

GET

/content/monthly-archive/{sign}/{yyyy_mm}

Archived monthly horoscope

  • yyyy_mm (path, required)
GET

/content/moon

Current moon phase article

GET

/content/transit

Today's transit article

GET

/content/week-ahead

Seven-day forecast

GET

/content/monthly-overview

Monthly overview article

GET

/search-location

Find coordinates for a city

  • q (query, required)

17 endpoints auto-detected

curl -X GET \
  "https://cosmyday.com/api-docs/health"

cosmyday.com · HTTPS only