Recommendation API

Turn a birth date into films, series and books that match a person's story. A public API for apps, publishers and book clubs.

The Cosmic Narrative engine reads a real natal chart as a character from literature, film and theatre, then finds the works whose character networks resonate with it. It powers AstroNext's Archetype experience and is now available as a simple API for other apps and websites.

How it works

1 · Send a birth chart

Send the person's birth date, time and place — plus your API key — and the engine does the rest.

2 · Get tailored picks

The engine returns films, series and books ranked by how closely their character networks match the chart — and which titles resonate with today's sky.

3 · Render & earn

Every pick ships with posters, covers, availability and deep links — ready to render in your UI. Bring your own affiliate links, or use ours.

Bring the story engine to your app

If your audience would love a 'your life as a movie & book list' experience, we'd love to power it.

Email partners@astro-next.com →

Free starter tier · No credit card · Higher-volume plans for bigger integrations.

Data sources (TMDB, Wikipedia, Open Library, DraCor) require attribution, returned with every response. Where we provide affiliate links, please show the disclosure text included in the payload.

API referenceEndpoint, authentication and code examples — for developers integrating the API.▾
Endpoint

POST https://api.astro-next.com/v1/recommendations

Authentication: Third-party access uses API keys. Send your key in the x-api-key header. Keys are issued per partner, can be revoked instantly, and are rate-limited by plan.

Get a key: We onboard partners manually for now. Write to us with a few lines about your app and audience and we'll set you up with a free test key.

Example request
POST /v1/recommendations
x-api-key: anp_<YOUR_PARTNER_API_KEY>
Content-Type: application/json

{
  "birthDate": "1990-11-10",
  "birthTime": "14:30",
  "lat": 44.43,
  "lon": 26.10,
  "country": "RO"
}
Sample response
{
  "meta": {
    "partner": { "plan": "free", "tagMode": "affiliate" }
  },
  "archetype": { "dominantSign": "scorpio" },
  "recommendations": {
    "movies": [
      {
        "title": "Se7en",
        "type": "movie",
        "year": 1995,
        "similarity": 0.912,
        "providers": ["Max"],
        "links": {
          "max": "https://play.max.com/...",
          "justwatch": "https://www.justwatch.com/..."
        }
      }
    ],
    "books": [
      {
        "title": "Crime and Punishment",
        "similarity": 0.88,
        "links": {
          "audible": "https://www.audible.com/...",
          "amazon": "https://www.amazon.com/...",
          "goodreads": "https://www.goodreads.com/..."
        }
      }
    ]
  },
  "attribution": { "disclosureText": "..." }
}