Documentação da API
Todos os endpoints, com o corpo exato da requisição e um exemplo de resposta — na maioria dos casos, capturado de um servidor real. Envie sua chave no cabeçalho X-API-Key. Cada chamada bem-sucedida custa um crédito, não importa o que você peça nela. As exceções são os dois relatórios em PDF e o endpoint de chat, que custam 25.
https://api.occultapi.comO que dá para construir com estes endpoints
Interfaces feitas com a API. Cada card mostra o endpoint por trás dela.
299 endpoints, 330 recursos pesquisáveis
IA e chat
Relatórios em PDF
Panchang
POSTLeituras do panchanga de nascimento (seus elementos)
/api/astro/birth-panchanga-effects/POSTChandrabala
/api/astro/chandrabala/POSTDuração do dia e da noite
/api/astro/day-night-length/POSTDisha shool
/api/astro/disha-shool/POSTKarana
/api/astro/karana/POSTVarredura de karana
/api/astro/karana_scan/POSTMês lunar
/api/astro/lunar-month/POSTFase lunar
/api/astro/lunar-phase/POSTVarredura de mês lunar
/api/astro/lunar_month_scan/POSTNakshatra
/api/astro/nakshatra/POSTNitya yoga
/api/astro/nitya-yoga/POSTPanchak
/api/astro/panchak/POSTPanchang (cinco membros)
/api/astro/panchang/POSTEfeitos do panchanga de nascimento (tabela de referência)
/api/astro/panchang_element_birth_effect/13 recursosPOSTNomes dos elementos do panchanga
/api/astro/panchanga-elements/POSTPanchanga
/api/astro/panchanga/57 recursosPOSTPanchanga yogas
/api/astro/panchanga_yogas/POSTAnos samvat
/api/astro/samvat/POSTDatas de Sankranti
/api/astro/sankranti/POSTTarabala
/api/astro/tarabala/POSTTithi
/api/astro/tithi/POSTVarredura anual de tithi
/api/astro/tithi_scan/POSTVarredura anual do Nitya Yoga
/api/astro/yoga_scan/Muhurta e horários
POSTAbhijit muhurat
/api/astro/abhijit-muhurat/POSTAtividades por dia da semana
/api/astro/activities_day_of_week/2 recursosPOSTAmrit kaal
/api/astro/amrit-kaal/POSTHorários auspiciosos
/api/astro/auspicious-timings/POSTBrahma muhurat
/api/astro/brahma-muhurat/POSTChoghadiya
/api/astro/choghadiya/POSTDurmuhurat
/api/astro/durmuhurat/POSTHoras planetárias (hora)
/api/astro/hora/POSTHorários inauspiciosos
/api/astro/inauspicious-timings/POSTMuhurats de cerimônias
/api/astro/muhurat/1 recursoPOSTTabela de muhurtas
/api/astro/muhurta-table/POSTRahu kaal
/api/astro/rahu-kaal/POSTJanelas de Ravi yoga
/api/astro/ravi_yoga/POSTJanelas de sandhya
/api/astro/sandhya/POSTAgni vasa e Shiva vasa
/api/astro/vasa-segments/Nascer do sol e da lua
Lua
Calendários
POSTCalendário assamês
/api/astro/assamese_calendar/POSTCalendário bengali
/api/astro/bengali_calendar/POSTCalendário gujarati
/api/astro/gujarati_calendar/POSTCalendário ISKCON
/api/astro/iskcon_calendar/POSTCalendário kannada
/api/astro/kannada_calendar/POSTCalendário malaiala
/api/astro/malayalam_calendar/POSTCalendário marathi
/api/astro/marathi_calendar/POSTPanchang mensal
/api/astro/monthly_panchang/POSTCalendário nepalês
/api/astro/nepali_calendar/POSTCalendário odia
/api/astro/odia_calendar/POSTCalendário de Onam
/api/astro/onam_calendar/POSTCalendário tâmil
/api/astro/tamil_calendar/POSTCalendário telugu
/api/astro/telugu_calendar/Festivais e vrats
Mapa natal e casas
POSTAtributos do mapa
/api/astro/attributes/POSTCúspides dos bhavas
/api/astro/bhava-cusps/POSTMapa natal
/api/astro/chart/POSTAnálise do mapa
/api/astro/chart_analysis/POSTPosicionamentos dos senhores das casas (todos os 144)
/api/astro/effect_house_lord_different_house/1 recursoPOSTCúspides das casas
/api/astro/house/7 recursosPOSTRelações entre casas
/api/astro/house_hora/29 recursosPOSTSignificações das casas
/api/astro/house_information/1 recursoPOSTPosição do senhor da casa (um par)
/api/astro/house_lord_particular_house/1 recursoPOSTLagnas especiais
/api/astro/lagna/POSTParte da Fortuna
/api/astro/part-of-fortune/Mapas divisionais
POSTRashi (D1)
/api/astro/rashi/POSTMapa hora (D2)
/api/astro/hora-chart/POSTDrekkana (D3)
/api/astro/drekkana/POSTChaturthamsa (D4)
/api/astro/chaturthamsa/POSTPanchamsa (D5)
/api/astro/panchamsa/POSTShashthamsa (D6)
/api/astro/shashthamsa/POSTSaptamsa (D7)
/api/astro/saptamsa/POSTAshtamsa (D8)
/api/astro/ashtamsa/POSTNavamsa (D9)
/api/astro/navamsa/POSTDasamsa (D10)
/api/astro/dasamsa/POSTRudramsa (D11)
/api/astro/rudramsa/POSTDwadasamsa (D12)
/api/astro/dwadasamsa/POSTShodasamsa (D16)
/api/astro/shodasamsa/POSTVimsamsa (D20)
/api/astro/vimsamsa/POSTChaturvimsamsa (D24)
/api/astro/chaturvimsamsa/POSTNakshatramsa (D27)
/api/astro/nakshatramsa/POSTTrimsamsa (D30)
/api/astro/trimsamsa/POSTKhavedamsa (D40)
/api/astro/khavedamsa/POSTAkshavedamsa (D45)
/api/astro/akshavedamsa/POSTShashtyamsa (D60)
/api/astro/shashtyamsa/POSTNavnavamsa (D81)
/api/astro/navnavamsa/POSTAstottaramsa (D108)
/api/astro/astottaramsa/POSTDwadasdwadasamsa (D144)
/api/astro/dwadasdwadasamsa/Jaimini
KP (Krishnamurti Paddhati)
Chakras
Planetas e posições
GETValor do ayanamsa
/api/astro/ayanamsa_value/POSTPosições celestes
/api/astro/celestial/31 recursosPOSTO que um planeta aspecta
/api/astro/planet-aspects/POSTCoordenadas equatoriais dos planetas
/api/astro/planet-equatorial/POSTAmizades planetárias naturais
/api/astro/planet-friendships/POSTCoordenadas horizontais dos planetas
/api/astro/planet-horizon/POSTPosições planetárias
/api/astro/planet-positions/POSTLeituras de posicionamento planetário
/api/astro/planet_insights/3 recursosPOSTEstrelas fixas
/api/astro/star/10 recursosPOSTUpagrahas
/api/astro/upagraha/POSTDetalhes planetários
/api/planetary_details/Força (bala)
Ashtakavarga
Dashas — nakshatra (planetárias)
POSTAshtottari dasha
/api/astro/dasha/ashtottari/POSTBudhi Gati dasha
/api/astro/dasha/budhi-gati/POSTChaturaseeti Sama dasha
/api/astro/dasha/chaturaseeti-sama/POSTDwadashottari dasha
/api/astro/dasha/dwadashottari/POSTDwisaptati Sama dasha
/api/astro/dasha/dwisaptati/POSTDasha nakshatra (qualquer sistema)
/api/astro/dasha/nakshatra/POSTPanchottari dasha
/api/astro/dasha/panchottari/POSTSataabdika dasha
/api/astro/dasha/sataabdika/POSTShattrimsa Sama dasha
/api/astro/dasha/shattrimsa-sama/POSTShodashottari dasha
/api/astro/dasha/shodashottari/POSTVimshottari dasha
/api/astro/dasha/vimshottari/POSTYogini dasha
/api/astro/dasha/yogini/Dashas — rashi (Jaimini)
POSTBrahma dasha
/api/astro/dasha/brahma/POSTChakra dasha
/api/astro/dasha/chakra/POSTChara dasha
/api/astro/dasha/chara/POSTDrig dasha
/api/astro/dasha/drig/POSTKalachakra dasha
/api/astro/dasha/kalachakra/POSTKendradhi dasha
/api/astro/dasha/kendradhi/POSTLagnamsaka dasha
/api/astro/dasha/lagnamsaka/POSTMandooka dasha
/api/astro/dasha/mandooka/POSTNarayana dasha
/api/astro/dasha/narayana/POSTNavamsa dasha
/api/astro/dasha/navamsa/POSTNirayana Shoola dasha
/api/astro/dasha/nirayana-shoola/POSTParyaaya dasha
/api/astro/dasha/paryaaya/POSTDasha rashi (qualquer sistema)
/api/astro/dasha/rashi/POSTSandhya dasha
/api/astro/dasha/sandhya/POSTShoola dasha
/api/astro/dasha/shoola/POSTSthira dasha
/api/astro/dasha/sthira/POSTSudasa dasha
/api/astro/dasha/sudasa/POSTTara Lagna dasha
/api/astro/dasha/tara-lagna/POSTTrikona dasha
/api/astro/dasha/trikona/POSTYogardha dasha
/api/astro/dasha/yogardha/Ferramentas de dasha
Yogas e doshas
Lal Kitab
Compatibilidade
POSTCompatibilidade Ashtakoota (Gun Milan)
/api/astro/ashtakoota/25 recursosPOSTBusca de estrela do parceiro
/api/astro/compatibility_match/POSTCompatibilidade para casamento
/api/astro/horoscope-match/POSTYogas de casamento Naadi
/api/astro/naadi_marriage_prediction/1 recursoPOSTPorutham (compatibilidade sul-indiana)
/api/astro/porutham/Trânsitos e mapas anuais
POSTTrânsito sobre planeta natal
/api/astro/planet_transit_natal_planets/1 recursoPOSTTrânsito pela casa
/api/astro/planet_transit_over_house/1 recursoPOSTFases do trânsito de Saturno
/api/astro/shani_analysis/POSTCruzamentos de trânsito
/api/astro/transit/8 recursosPOSTInstantâneo do trânsito
/api/astro/transit/details/POSTCruzamento da Lua
/api/astro/transit/moon-crossing/POSTCruzamento do nodo lunar
/api/astro/transit/node-crossing/POSTPlaneta em um grau
/api/astro/transit/planet-at-degree/POSTIngresso solar
/api/astro/transit/solar-ingress/Tajika e varshaphala
POSTHarsha bala (Tajika)
/api/astro/harsha-bala/POSTMudda dasha (varsha vimshottari)
/api/astro/mudda-dasha/POSTMuntha (varshaphal)
/api/astro/muntha/POSTPancha vargeeya bala
/api/astro/pancha-vargeeya-bala/POSTPatyayini dasha
/api/astro/patyayini_dasha/1 recursoPOSTSahams (Partes Árabes)
/api/astro/sahams/POSTMapas anuais Tajika
/api/astro/tajika/POSTAspectos Tajika
/api/astro/tajika/aspects/POSTYogas Tajika
/api/astro/tajika/yogas/Varreduras e transições
Previsões e leituras
POSTPrevisões gerais
/api/astro/general_prediction/1 recursoPOSTLeituras de signo na casa
/api/astro/rashi_in_house_insights/1 recursoPOSTPrevisões do Rashifal
/api/astro/rashifal/4 recursosPOSTRashifal de hoje
/api/astro/rashifal/daily/POSTRashifal deste mês
/api/astro/rashifal/monthly/POSTRashifal de amanhã
/api/astro/rashifal/tomorrow/POSTRashifal desta semana
/api/astro/rashifal/weekly/POSTRashifal deste ano
/api/astro/rashifal/yearly/POSTRashifal de ontem
/api/astro/rashifal/yesterday/Prashna
GETPanchashalaka chakra
/api/astro/panchashalaka_chakra/GETConsulta de vedha do Panchashalaka
/api/astro/panchashalaka_vedha/POSTPontos sensíveis do Prashna
/api/astro/prashna/POSTAshtamangala Prashna
/api/astro/prashna/ashtamangala/POSTMapa de Jamakkol Prashna
/api/astro/prashna/jamakkol/GETSaptashalaka chakra
/api/astro/saptashalaka_chakra/GETConsulta de vedha do Saptashalaka
/api/astro/saptashalaka_vedha/Tarô
Pancha Pakshi
Revoluções
Eclipses
POSTAtributos do eclipse em um momento
/api/astro/eclipse/attributes/POSTVisibilidade local de eclipses
/api/astro/eclipse/local/POSTPróximo eclipse lunar
/api/astro/eclipse/next-lunar/POSTPróximo eclipse solar
/api/astro/eclipse/next-solar/POSTEclipses em um intervalo de datas
/api/astro/eclipse/range/POSTPróximos eclipses
/api/astro/eclipse/upcoming/POSTTrajetória de visibilidade do eclipse
/api/astro/eclipse/visibility-path/Astrologia mundial
POSTMapas de ingresso mundanos
/api/astro/mundane-charts/POSTAstrologia mundana
/api/astro/mundane/24 recursosPOSTConjunções planetárias
/api/astro/mundane/conjunctions/POSTLinha do tempo de eventos celestes
/api/astro/mundane/events/POSTIngressos nos signos
/api/astro/mundane/ingresses/POSTLuas novas e cheias
/api/astro/mundane/lunations/POSTEstações retrógradas
/api/astro/mundane/stations/POSTChakras mundanos de nakshatras
/api/astro/nakshatra-chakras/POSTRegentes do ano hindu
/api/astro/samvatsara/POSTEquinócios, solstícios e ritus
/api/astro/seasons/Estrelas fixas
Tradicional e helenística
Astrologia ocidental
POSTAntíscios e contra-antíscios
/api/astro/western/antiscia/POSTMapa composto
/api/astro/western/composite/POSTMapa de relacionamento Davison
/api/astro/western/davison/POSTMapa dracônico
/api/astro/western/draconic/POSTMapa harmônico
/api/astro/western/harmonic/POSTMapa heliocêntrico
/api/astro/western/heliocentric/POSTCúspides das casas ocidentais
/api/astro/western/house-cusps/POSTMapa natal ocidental
/api/astro/western/natal-chart/POSTPlanetas ocidentais (tropicais)
/api/astro/western/planets/POSTProgressões secundárias
/api/astro/western/progressions/POSTSinastria
/api/astro/western/synastry/POSTTrânsitos sobre o mapa natal
/api/astro/western/transits/Numerologia
POSTNumerologia
/api/astro/numerology/34 recursosPOSTNumerais abjad
/api/astro/numerology/abjad/POSTNúmeros angelicais
/api/astro/numerology/angel/POSTNumerologia da aura
/api/astro/numerology/aura/POSTNumerologia caldeia
/api/astro/numerology/chaldean/POSTNumerologia de Cheiro
/api/astro/numerology/cheiro/POSTNumerologia chinesa
/api/astro/numerology/chinese/POSTGematria hebraica
/api/astro/numerology/gematria/POSTNumerologia do I Ching
/api/astro/numerology/iching/POSTIsopsefia grega
/api/astro/numerology/isopsephy/POSTNumerologia cabalística
/api/astro/numerology/kabbalah/POSTNumerologia pitagórica
/api/astro/numerology/pythagorean/POSTNumerologia de Sepharial
/api/astro/numerology/sepharial/POSTNumerologia do tarô
/api/astro/numerology/tarot/POSTNumerologia védica
/api/astro/numerology/vedic/Astrologia chinesa
Astrocartografia
Human Design
Desastres naturais
Utilitários
Astrologia
Prashnavali
Referência de erros
| Status | Código | O que significa | O que fazer |
|---|---|---|---|
| 401 | invalid_api_key | A chave está errada, foi revogada ou expirou. | Confira o cabeçalho X-API-Key. Se você trocou a chave, faça o deploy da nova. |
| 402 | insufficient_credits | A chave é válida — o que acabou foram os créditos. | Mude para um plano maior ou aguarde a cota recomeçar no próximo mês. Não é problema de autenticação; não gere outra chave. |
| 403 | endpoint_not_allowed | Essa rota não está disponível para chaves de API: o caminho ou o método está errado, ou o endpoint foi descontinuado. | Compare a rota e o método com a referência. Tentar de novo não adianta. |
| 403 | scope_not_allowed | Sua chave não tem o escopo que este endpoint exige. | Crie uma chave com os escopos certos, ou deixe os escopos vazios para liberar todos. |
| 403 | ip_not_allowed | A chave tem uma lista de IPs permitidos, e esta requisição veio de outro endereço. | Chame a partir de um IP permitido, ou crie uma chave com os IPs certos. |
| 403 | account_suspended | A conta está suspensa, então todas as chaves dela são recusadas. | Fale com o suporte. Uma chave nova não resolve. |
| 429 | api_key_rate_limited | Requisições demais no mesmo minuto. | Espere e tente de novo após os segundos indicados em Retry-After. |
| 400 | (erros de campo) | O corpo da requisição tem algum erro. | Leia message: ele aponta cada campo. Nunca é cobrado. |


