/api/astro/panchanga_yogas/1 créditoPanchanga yogas
Um Panchanga yoga é uma qualidade com nome próprio, boa ou ruim, que marca o dia inteiro e resulta da combinação do dia lunar (tithi), do dia da semana (vaara) e da mansão lunar (nakshatra) daquele dia. Sarvartha Siddhi ("todos os objetivos se realizam"), Amrit Siddhi, Tripushkara, Dagdha, Mrityu e Yamaghanta são os mais conhecidos. A prática de muhurta os usa como primeiro filtro: escolha um dia com uma combinação benéfica e evite um dia com uma maléfica. Esta é a varredura por dia. Ela percorre cada dia do calendário do ano solicitado, avalia os yogas uma única vez, no nascer do sol daquele dia, e retorna apenas os dias que têm pelo menos um. A resposta é `data.days`, uma lista de `{date, yogas}` em que `date` é `YYYY-MM-DD` e `yogas` é uma lista de nomes; os dias sem nada a informar ficam totalmente de fora. A maioria dos nomes traz entre parênteses a convenção de origem, por exemplo "Amrit Yoga (Vaara Tithi Yoga)" ou "Padma Yoga (Vashishta Samhita Yogas)", porque vários textos clássicos definem conjuntos que se sobrepõem. Os yogas são lidos no nascer do sol, então a latitude, a longitude e `timezone_as_float` alteram o resultado. O padrão de `use_28_nakshatras` é true, o que insere Abhijit como um nakshatra independente; alguns yogas, como o Kaana Yoga de segunda-feira, são definidos em termos de Abhijit e não podem aparecer sem ele. Defina como false para usar a lista simples de 27 nakshatras. Este endpoint não tem relação com `/api/astro/yogas/`, que encontra combinações de planetas em um mapa natal; nada aqui consulta um mapa natal. Para o Ravi Yoga especificamente, `/api/astro/ravi_yoga/` fornece horários exatos de início e fim, em vez de uma flag por dia.
https://api.occultapi.com/api/astro/panchanga_yogas/
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 |
|---|---|---|---|
| latitude | number (double) | obrigatório | Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. |
| longitude | number (double) | obrigatório | Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. |
| 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 |
| use_28_nakshatras | boolean | opcional |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/panchanga_yogas/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"days\": [{\"date\": \"2026-01-01\", \"yogas\": [\"utpaata\", \"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Utpaata/Pravas (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-02\", \"yogas\": [\"Ravi Yoga (Sun and Moon Nakshatra)\", \"Upagraha Dosha\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Padma Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-03\", \"yogas\": [\"Mrityu (Vaara Tithi Yoga)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-05\", \"yogas\": [\"sarvartha_siddhi\", \"Always bestows welfare (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Sarvarth-Siddha Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Maha Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-06\", \"yogas\": [\"sarvartha_siddhi\", \"Dhumra Vashishta Samhita Yoga (Malefic)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-09\", \"yogas\": [\"Ravi Yoga (Sun and Moon Nakshatra)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Padma Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-10\", \"yogas\": [\"mrityu\", \"yama_ghanta\", \"Mrityu/Maran (Vaara Nakshatra Malefic/Bad Yoga)\", \"Yamaghanta (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Vimardan Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-11\", \"yogas\": [\"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Saumya Yog (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-12\", \"yogas\": [\"Auspicious for all types of works (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Maha Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-13\", \"yogas\": [\"Din Mrityu Yoga\", \"Halahalopam Yogas (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-14\", \"yogas\": [\"amrit_siddhi\"]}, {\"date\": \"2026-01-16\", \"yogas\": [\"Upagraha Dosha\", \"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Sarvarth-Siddha Yoga (Vaara Nakshatra Auspicious/Good Yogas)\"]}, {\"date\": \"2026-01-17\", \"yogas\": [\"Din Mrityu Yoga\", \"Upagraha Dosha\", \"Prashasta Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\"]}, {\"date\": \"2026-01-18\", \"yogas\": [\"Amrit Yoga (Vaara Tithi Yoga)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-19\", \"yogas\": [\"kaana\", \"Ratnakur Yoga (Vaara Tithi Yoga)\", \"Kaana/Vyadhi (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-20\", \"yogas\": [\"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-21\", \"yogas\": [\"dagdha_nakshatra\", \"panchaka\", \"Auspicious for Manglik works (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Tithi-Nakshatra-Vaara combination Malefic/Bad Yogas\", \"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Mrityu (Vaara Tithi Yoga)\", \"Dagdha (Vashishta's opinion) (Vaara Tithi Yoga)\", \"Dagdha (Brihaspati's opinion) (Vaara Tithi Yoga)\", \"Dagdha (Vaara Nakshatra Malefic/Bad Yoga)\", \"Vish Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-22\", \"yogas\": [\"panchaka\", \"Tithi-Nakshatra-Vaara combination Malefic/Bad Yogas\", \"Mrityu (Vaara Tithi Yoga)\", \"Dagdha (Brihaspati's opinion) (Vaara Tithi Yoga)\", \"Vish Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Amrit Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-23\", \"yogas\": [\"panchaka\", \"Ratnaku"
}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.