A daily horoscope app that is not the same text for everyone
Sun-sign for the top of the funnel, chart-grounded for retention.
Sun-sign horoscopes are cheap to serve and get people in the door, but twelve daily strings is also why most horoscope apps churn. The upgrade path is the same API: once you hold a birth time and place, the same daily slot can be driven by the user's own nakshatra, dasha and transits.
9 endpoints across 4 stages.
Worth knowing first
Sun sign is a hook, not a product
Twelve variants of a daily reading are identical for millions of people, and users notice. Collecting a birth time and coordinates once lets every subsequent day be computed for that person - and that is the difference between a novelty and a habit.
Stage 1
Day one: sun sign
No onboarding, no birth time. Two GETs, cacheable per sign per day.
Stage 2
After onboarding: their own chart
Once you have date, time and coordinates, the daily reading can be scoped to the user's nakshatra rather than their sun sign - 27 buckets instead of 12, and computed against a real chart.
Stage 3
Why today is different
The reason a reading changes day to day is the transits and the running dasha. Surfacing them turns a horoscope into something with a visible mechanism.
Stage 4
The retention loop
Sade Sati and dasha changes are long-running states people check back on. They are also the honest reason to send a push notification.
Start
One key covers all of it
Every endpoint above takes the same bearer token and returns the same envelope. Free tier covers 1,000 requests / month. Pick your language in the quickstarts, or run any of these without a key in the playground.
Other use cases