/api/astro/lunar_month_scan/1 créditoVarredura de mês lunar
Encontra os instantes exatos de início e fim de um mês lunar hindu específico — Chaitra, Vaisakha, Jyeshtha e assim por diante — dentro de um ano civil. Útil para agendar tudo o que segue o mês lunar, e não o gregoriano. reckoning define onde ficam os limites. Em 'amanta' (o padrão, usado no sul e no oeste), um mês vai de uma lua nova à seguinte e recebe o nome do signo da Lua na lua nova que o abre. Em 'poornima', vai de uma lua cheia à seguinte e recebe o nome do signo do Sol na lua cheia que o abre; é a contagem dos calendários do norte e, na quinzena escura, as duas contagens colocam o mesmo dia em meses com nomes diferentes. Passe month_name, year e timezone_as_float; não é preciso informar o local. A resposta é {year, month_name, reckoning, rows}, em que rows é uma lista de timestamps UTC {start, end} — em geral uma entrada, e duas quando um mês adhika (intercalar) de mesmo nome também cai naquele ano. A varredura não indica qual dos dois é o mês intercalar.
https://api.occultapi.com/api/astro/lunar_month_scan/Autenticação
Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos da requisição
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| month_name | string | obrigatório | VaisakhaJyeshthaAshadhaShravanaBhadrapadaAshwinKartikaMargashirshaPaushaMaghaPhalgunaChaitra |
| timezone_as_float | number (double) | obrigatório | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. |
| year | integer | obrigatório | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400 |
| reckoning | string | opcional | amantapoornima |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/lunar_month_scan/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"month_name":"Vaisakha","timezone_as_float":5.5,"year":2026,"reckoning":"amanta"}'Resposta
{
"data": {
"year": 2026,
"month_name": "Vaisakha",
"reckoning": "amanta",
"rows": [
{
"start": "2026-04-17T11:52:21+00:00",
"end": "2026-05-16T20:01:32+00:00"
}
]
},
"message": "successful",
"is_error": false
}Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.
Erros
Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.