Aplicativos de Astrologia

Estás a construir uma aplicação astro ao estilo Co-Star, Sanctuary, The Pattern, Chani ou Costar Compat? O AstroWay API elimina a necessidade de licenciar o Solar Fire ($495) ou de escrever o teu próprio motor de efemérides: 771 endpoints (mapas natais, sinastria, trânsitos, Human Design, interpretações AI), OpenAPI 3.1 mais SDK publicados para TypeScript, Python e PHP, precisão Swiss Ephemeris – o mesmo motor que o Astrodienst e o Kepler.

Arquitetura típica

User (browser / mobile)
     ↓
Your backend (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSON response → render in your UI

Cuidado

Nunca coloques a chave da API no código do frontend. As chamadas ao AstroWay API devem passar pelo teu backend ou funções de servidor (Next.js API routes, Vercel Functions, AWS Lambda).

Endpoints principais para a aplicação astro

MVP (produto mínimo)

Endpoint	Créditos	Para que
/v1/chart	20	Construção do mapa natal
/v1/synastry	50	Compatibilidade de duas pessoas
/v1/horo​scope/daily	50	Horóscopo diário

Três endpoints – e já tens um produto funcional com mapa natal, compatibilidade e conteúdo diário.

Produto avançado

Endpoint	Créditos	Para que
/v1/transits	50	Trânsitos atuais para o mapa natal
/v1/solar-return	50	Solar (mapa anual)
/v1/progressions	50	Progressões secundárias
/v1/interpret/natal	100	Interpretação AI do mapa natal
/v1/transit-calendar	100	Calendário de eventos de trânsito
/v1/human-design	50	Mapa HD

Funcionalidades premium

Endpoint	Créditos	Para que
/v1/rectification	500	Correção da hora de nascimento
/v1/acg	50	Astrocartografia (onde é melhor viver)
/v1/forecast-calendar	100	Previsão anual – heatmap
/v1/group-synastry	100	Compatibilidade de grupo

Estimativa de orçamento

Cenário: 100 DAU (utilizadores ativos diários)

Assumimos que o utilizador médio faz 3 ações por dia:

Ação	Endpoint	Créditos	Pedidos/dia	Créditos/dia
Visualização do mapa	/v1/chart	20	100	2 000
Horóscopo diário	/v1/horo​scope/daily	50	100	5 000
Compatibilidade	/v1/synastry	50	30	1 500
Total			230	8 500/dia

~255 000 créditos/mês (8 500 × 30) → plano Pro ($59/mês, 800 000 créditos) com grande margem, ou Starter ($19/mês, 200 000) com um overage de ~ $30 por 55 K extras ($5 por cada 10 000 acima da quota). O cache do horóscopo diário (um texto por signo, não por utilizador) remove 4 850 créditos por dia desta conta e devolve o cenário ao Starter.

Cenário: MVP com 20 DAU

Ação	Créditos/dia
20 mapas	400
20 horóscopos	1 000
5 sinastrias	250
Total	1 650/dia

~49 500 créditos/mês – plano Indie ($5/mês, 50 000 créditos) cobre 99% disso, ou seja, sem margem: o primeiro aumento de tráfego recai sobre o overage ou no Starter. Com o cache dos horóscopos (12 chamadas por dia em vez de 20) resulta em ~35 000 e a margem aparece.

Dicas

• Cache os mapas natais: a entrada é imutável (a data de nascimento não muda), por isso o resultado pode ser cacheado para sempre na tua BD
• Cache os horóscopos por dia: o horóscopo diário é o mesmo para todas as pessoas de um signo, gera‑o uma vez e distribui
• Chaves sandbox (aw_test_*): para desenvolvimento, não consomem créditos
• Clientes tipados: instala @astroway/sdk, astroway ou astroway/sdk; para outra linguagem gera o cliente a partir de /v1/openapi.json usando openapi-typescript ou openapi-python-client

Início rápido → Primeira chamada em 5 minutos

Birth Chart API Detalhes da carta natal

Tarifas Do gratuito ao Enterprise