API de dados de horóscopo e astrologia para parceiros
Uma API JSON somente leitura sobre as mesmas efemérides de alta precisão que movem a Sigastra: horóscopos diários, semanais e mensais para os doze signos em quinze idiomas, além de fase da Lua ao vivo, aspectos planetários de hoje e compatibilidade de signos. Sem conta e sem fatura; chamadas do servidor informam o seu site (endereço ou chave grátis). A única condição é a atribuição, e uma tag canonical quando você publicar o texto completo.
Experimente
GET /api/v1/daily?lang=en&sign=leoRoda contra a API em produção direto do seu navegador. O CORS está aberto, então isto também é um exemplo funcional de integração no cliente.
Endpoints
GET /api/v1/daily | lang, sign, full | O horóscopo de hoje. Os doze signos, ou um só. |
GET /api/v1/weekly | lang, sign, full | A semana atual, com sua chave de período e rótulo de intervalo. |
GET /api/v1/monthly | lang, sign, full | O mês atual. |
GET /api/v1/moon | lang | Fração iluminada, fase, crescente/minguante, signo lunar. Efemérides puras. |
GET /api/v1/cosmic | lang | Os aspectos planeta a planeta mais fechados do dia, com orbes. Efemérides puras. |
GET /api/v1/compat | lang, a, b | Compatibilidade determinística de signos: pontuação, faixa, relação de elemento e modalidade. |
Parâmetros
- lang
- Um dos quinze idiomas servidos (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Qualquer outro cai para o inglês em vez de dar erro.
- sign
- A chave em inglês (leo), o slug em inglês (leo) ou o slug do próprio idioma (leao). Omita para os doze.
- full
- full=1 devolve o texto completo em vez de uma prévia. É o modo de sindicação e liga a obrigação do canonical.
- a, b
- Só para compat. Dois signos, em qualquer uma das formas aceitas.
Prévia ou texto completo
Por padrão cada item carrega uma prévia: o bastante para um card, uma barra lateral ou uma linha de feed. Acrescente full=1 e você recebe o corpo completo, mais um objeto sections correspondente à página de origem. O texto completo é feito para republicação, então o objeto attribution muda canonicalRequired para true e te entrega a tag exata para colar.
Limite de taxa
10 requisições por segundo por IP na borda, pico de 30, e um teto diário de 1.500 requisições por endereço. Um veículo que consulta doze signos entre diário, semanal e mensal, quatro vezes por dia, gasta cerca de 150: você não vai encostar em nenhum dos dois limites. Acima do teto a resposta é HTTP 429 com um link para esta página. Precisa de mais volume? Escreva para info@sigastra.com e diga onde o conteúdo é publicado.
Exemplos
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=pt-BR&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "https://sigastra.com/api/v1/weekly?lang=pt-BR&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=pt-BR&sign=leo");
const { items, attribution } = await res.json();
document.querySelector("#horoscope").textContent = items[0].text;
document.querySelector("#credit").outerHTML =
`<a href="${attribution.localizedHref}">${attribution.text}</a>`;
// Publishing the FULL text (full=1)? Also put this in <head>:
// attribution.canonicalTagCanais do Telegram, passo a passo
- Abra sigastra.com/api/partners/verify?site=t.me/seucanal. O canal precisa ser público; você recebe a chave grátis na hora, e o teste de três dias começa com a primeira chamada.
- Seu bot chama a API com a chave, por exemplo /api/v1/daily?lang=pt-BR&sign=leo&key=SUA_CHAVE, e publica o texto (encurtado ou traduzido pode, veja os termos).
- Pelo menos um dos seus dez últimos posts tem link para sigastra.com com a palavra “Sigastra”, sem intervalo de mais de sete dias. Verificamos automaticamente a prévia pública do canal.
Perguntas frequentes sobre a API
A API de horóscopo é mesmo gratuita?+
Sim, em qualquer site, comercial ou não. Você tem três dias de teste a partir da primeira chamada. Depois disso, sua página é verificada automaticamente a cada poucas horas: sem o link, o conteúdo pausa, e volta assim que o link é medido de novo. Para verificar na hora, abra sigastra.com/api/partners/verify?site=seudominio.com.br.
Preciso de uma chave de API?+
Chamadas feitas pelo navegador (os widgets, ou uma página que consulta a API sozinha) enviam o endereço da página por conta própria e não precisam de mais nada. Chamadas do seu servidor precisam dizer para qual site é o conteúdo: envie o endereço dessa página no cabeçalho Referer (nosso plugin para WordPress faz isso por você). Quando o seu site passa na verificação do link, o endereço de verificação também te dá uma chave grátis. A partir de 15 de outubro de 2026, uma chamada de servidor que não envie nem um nem outro é recusada.
Qual é o limite de taxa?+
10 requisições por segundo por IP na borda, pico de 30, mais um teto diário de 1.500 requisições por endereço. Um veículo gasta cerca de 150 por dia e não encosta em nenhum dos dois. Acima do teto: HTTP 429: para mais volume, escreva para info@sigastra.com.
Posso republicar o horóscopo inteiro?+
Pode, com full=1, e então você precisa acrescentar a tag canonical que o payload fornece. Sem ela, duas páginas idênticas competem e o buscador escolhe uma; a canonical é o que impede que essa escolha seja cara ou coroa.
Quais idiomas a API de astrologia cobre?+
Quinze: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Nomes de signos, planetas, aspectos e fases são todos localizados.
Os dados são calculados ou escritos?+
As duas coisas. As posições dos planetas, a fase da Lua e os aspectos são calculados a partir das efemérides. O texto do horóscopo é escrito uma vez por dia por uma IA (Claude, da Anthropic) a partir das posições calculadas daquele dia e depois fica em cache: a API nunca escreve nada a seu pedido, só lê o que já existe.
Posso usar isto em um aplicativo de celular?+
Não em um aplicativo nativo. O programa é gratuito porque o conteúdo fica em uma página ou canal público que leva o link, e um aplicativo não tem nem um nem outro. Um site ou um canal público do Telegram pode; para qualquer outra coisa, escreva para info@sigastra.com.
Tudo aqui é gratuito. A única condição é um link visível: mais uma tag canonical se você publicar o texto completo.
Como funciona o grátis
- 3 dias para testar: nesse período o link ainda não é exigido.
- A partir do dia 4: um link visível para sigastra.com cujo texto contenha a palavra "Sigastra", na página que mostra o conteúdo, legível por qualquer pessoa sem login. Seu idioma serve: "Powered by Sigastra", "Dados astronômicos por Sigastra" ou só "Sigastra". Não dentro do frame do widget nem escondido. Adicionar rel="nofollow" é escolha sua.
- Sem ele, o conteúdo pausa em todas as superfícies (widget, imagens, JSON) e a resposta diz exatamente o que adicionar. Medimos sua página ao vivo automaticamente.
Colocou o link? Abra /api/partners/verify?site=seu-dominio.com.br e o conteúdo volta em minutos. Uma chave de parceiro gratuita é emitida para o seu site automaticamente assim que o link é medido.