Developers · API v1
Molino's public API
The same calculation engine as the app, for your applications, bots or sites. Free, with open CORS and no sign-up. Responses are in Spanish.
A sample query
curl "https://www.molino.app/api/v1/map?date=1990-03-15"
"map": {
"numerology": { "lifePath": 1 },
"astrology": { "sunSign": "Piscis" },
"chineseZodiac": { "animal": "Caballo" },
...
}Nothing stored
Queries are stateless: we don't persist dates or identifiers on servers.
Open CORS
Call it directly from the browser with fetch, or from Node or Python backends.
Deterministic
The same parameters always return exactly the same result.
Endpoints
GET/api/v1/map
Complete Personal MapCalculates the Life Path, sun sign, Chinese zodiac animal and yearly cycles.
Query parameters (Query Params)
| Parameter | Type | Required | Description |
|---|---|---|---|
| date | string (YYYY-MM-DD) | Yes | Date of birth (e.g. 1990-03-15) |
| name | string | Optional | Optional name of the person being read |
Sample response (JSON):Try it live
{
"status": "success",
"query": { "date": "1990-03-15", "name": "Ana" },
"map": {
"numerology": { "lifePath": 1, "archetype": "El Iniciador" },
"astrology": { "sunSign": "Piscis", "element": "Agua" },
"chineseZodiac": { "animal": "Caballo", "element": "Metal" },
"cycles": { "personalYear": 9, "personalDay": 1 }
}
}GET/api/v1/daily
Daily Energy & FocusCalculates the daily vibration, moon phase, focus areas and recommendations.
Query parameters (Query Params)
| Parameter | Type | Required | Description |
|---|---|---|---|
| birthDate | string (YYYY-MM-DD) | Yes | Date of birth |
| targetDate | string (YYYY-MM-DD) | Optional | Date to query (default: today) |
Sample response (JSON):Try it live
{
"status": "success",
"dailyEnergy": {
"personalDay": 1,
"theme": "Iniciación",
"moonPhase": { "phase": "Luna Nueva", "emoji": "🌑" },
"areas": { "work": { "score": 85 }, "creativity": { "score": 90 } }
}
}GET/api/v1/compatibility
Compatibility & SynastryCrosses two maps to get a synastry score, connections and challenges.
Query parameters (Query Params)
| Parameter | Type | Required | Description |
|---|---|---|---|
| dateA | string (YYYY-MM-DD) | Yes | Date of birth of person A |
| dateB | string (YYYY-MM-DD) | Yes | Date of birth of person B |
Sample response (JSON):Try it live
{
"status": "success",
"compatibility": {
"score": 88,
"level": "Alta Resonancia",
"summary": "Excelente equilibrio entre agua y fuego.",
"connections": [...]
}
}