Aplicações de encontros

A compatibilidade astrológica é um motor de retenção em aplicações de encontros como Bumble, Hinge, Tinder e Tantan, e em apps astro-first como NUiT e Struck. A API AstroWay devolve uma pontuação de sinastria de 0 a 100 pronta a usar numa só chamada, sem motor de efemérides próprio e sem licença do Solar Fire ($495).

Como funciona

1. O utilizador indica a data, a hora e o local de nascimento no registo
2. Quando há match, o teu backend chama /v1/synastry com os dados das duas pessoas
3. A API devolve compatibility.score (0–100) e label (harmonious/balanced/mixed/challenging)
4. A pontuação entra como um dos fatores de ordenação

Match algorithm
  ├── Location proximity     (40%)
  ├── Interests overlap      (30%)
  ├── Astrology compatibility (20%)  ← AstroWay API
  └── Other signals          (10%)

Endpoints principais

Endpoint	Créditos	O que devolve
/v1/synastry	50	Aspetos cruzados + pontuação de 0 a 100
/v1/human-design/compatibility	100	Compatibilidade HD (tipo + estratégia)
/v1/horoscope/compatibility	50	Análise de compatibilidade em texto

Padrão de integração

// Call synastry on match
async function getCompatibility(userA: UserProfile, userB: UserProfile) {
  const result = await astrowayClient.synastry({
    chart1: {
      date: userA.birthDate,
      time: userA.birthTime || '12:00:00', // noon default if unknown
      timezoneOffset: userA.tzOffset,
      latitude: userA.birthLat,
      longitude: userA.birthLng,
    },
    chart2: {
      date: userB.birthDate,
      time: userB.birthTime || '12:00:00',
      timezoneOffset: userB.tzOffset,
      latitude: userB.birthLat,
      longitude: userB.birthLng,
    },
  });

  return {
    score: result.compatibility.score,      // 0-100
    label: result.compatibility.label,      // "harmonious"
    harmony: result.compatibility.harmony,  // weighted sum
    tension: result.compatibility.tension,
  };
}

Dica

O resultado da sinastria não muda: depende apenas das datas de nascimento. Guarda o par (userA_id, userB_id) → pontuação na tua base de dados. Uma chamada à API e nunca mais precisas de recalcular.

Estimativa de orçamento

Cenário: 1 000 novos matches por dia

Métrica	Valor
Matches/dia	1 000
Créditos/match	50 (synastry)
Créditos/dia	50 000
Créditos/mês	~1 500 000
Plano	Business ($199/mês, 3 500 000 créditos)

Cenário: 50 matches por dia (startup)

Métrica	Valor
Matches/dia	50
Créditos/dia	2 500
Créditos/mês	~75 000
Plano	Starter ($19/mês, 200 000 créditos)

Otimização

• Cache: guarda a pontuação na base de dados e não a recalcules
• Processamento preguiçoso: calcula a sinastria só quando o utilizador abre o match, e não para todos os pares possíveis
• Cálculo em lote no registo: calcula logo a compatibilidade com os 20 melhores matches potenciais

Sem hora de nascimento

Se o utilizador não souber a hora, envia "time": "12:00:00" (meio-dia). As casas ficam menos precisas, mas as posições dos planetas e os aspetos cruzados estão corretos. A pontuação de compatibilidade continua a ser informativa.

Na compatibilidade HD a hora pesa mais: usa hd/sensitivity para avaliar o impacto de uma hora imprecisa.

Synastry API → Os endpoints de compatibilidade em detalhe

Início rápido O primeiro pedido em 5 minutos

Preços Do plano gratuito ao Enterprise