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, sem chave, sem fatura — a única condição é a atribuição, e uma tag canonical quando você publicar o texto completo.

Experimente

full=1

GET /api/v1/daily?lang=en&sign=leo

Roda 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, com pico de 30, aplicado na borda. Um parceiro de sindicação consulta uma vez por dia por idioma e nunca vai vê-lo. Não há teto diário nem cota a solicitar.

Exemplos

curl -s "https://sigastra.com/api/v1/daily?lang=pt-BR&sign=leo" | jq .

curl -s "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.canonicalTag

Os termos, na íntegra

Grátis para qualquer site, comercial ou não. Sem conta, sem chave, sem tabela de preços.
Exiba o link visível “Powered by Sigastra”, do-follow, apontando para o localizedHref que devolvemos.
Se publicar o texto COMPLETO, acrescente o canonicalTag do payload ao <head> daquela página.
Não apresente o conteúdo como calculado por você — ele é calculado, e a atribuição é o que torna essa afirmação verificável.

Perguntas frequentes sobre a API

A API de horóscopo é mesmo gratuita?+

É — sem conta, sem chave, sem fatura, inclusive para sites comerciais. As condições são a atribuição e, para o texto completo, uma tag canonical.

Preciso de uma chave de API?+

Não. Os endpoints funcionam sem chave e são limitados por taxa na borda. O formato da resposta já carrega tudo a que uma chave se prenderia depois, então acrescentá-la não quebraria a sua integração.

Qual é o limite de taxa?+

10 requisições por segundo por IP, com pico de 30. Não há teto diário.

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?+

Calculados. Fase da Lua e aspectos saem direto das efemérides; o texto do horóscopo é gerado todos os dias a partir das posições planetárias reais daquele dia e guardado em cache — a API nunca gera na sua requisição, ela lê o que já está lá.

Tudo aqui é gratuito. A única condição é um link do-follow visível — mais uma tag canonical se você publicar o texto completo.

Widgets →Distribuição →WordPress →Visão geral →