API di dati oroscopo e astrologia per partner

Un’API JSON in sola lettura sulle stesse effemeridi ad alta precisione che fanno funzionare Sigastra: oroscopi giornalieri, settimanali e mensili per tutti e dodici i segni in quindici lingue, più fase lunare in tempo reale, aspetti planetari di oggi e compatibilità dei segni. Nessun account, nessuna chiave, nessuna fattura — l’unica condizione è l’attribuzione, e un tag canonical quando pubblichi il testo integrale.

Provalo

full=1

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

Gira sull’API in produzione direttamente dal tuo browser. CORS è aperto, quindi questo è anche un esempio funzionante di integrazione lato client.

Endpoint

`GET /api/v1/daily`	lang, sign, full	L’oroscopo di oggi. Tutti e dodici i segni, o uno solo.
`GET /api/v1/weekly`	lang, sign, full	La settimana corrente, con la chiave del periodo e l’etichetta dell’intervallo.
`GET /api/v1/monthly`	lang, sign, full	Il mese corrente.
`GET /api/v1/moon`	lang	Frazione illuminata, fase, crescente/calante, segno lunare. Effemeridi pure.
`GET /api/v1/cosmic`	lang	Gli aspetti pianeta-pianeta più stretti della giornata, con le orbite. Effemeridi pure.
`GET /api/v1/compat`	lang, a, b	Compatibilità deterministica dei segni: punteggio, fascia, relazione di elemento e modalità.

Parametri

lang: Una delle quindici lingue servite (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Qualsiasi altra ricade sull’inglese invece di dare errore.
sign: La chiave inglese (leo), lo slug inglese (leo) o lo slug della lingua stessa (leone). Omettilo per tutti e dodici.
full: full=1 restituisce il testo completo invece dell’anteprima. È la modalità sindacazione e attiva l’obbligo del canonical.
a, b: Solo per compat. Due segni, in una qualsiasi delle forme accettate.

Anteprima o testo integrale

Per impostazione predefinita ogni elemento porta un’anteprima — quanto basta per una scheda, una barra laterale o una riga di feed. Aggiungi full=1 e ottieni il corpo completo, più un oggetto sections corrispondente alla pagina di origine. Il testo integrale è pensato per la ripubblicazione, quindi l’oggetto attribution porta canonicalRequired a true e ti consegna il tag esatto da incollare.

Limite di frequenza

10 richieste al secondo per IP, con un picco di 30, applicato sul bordo della rete. Un partner che sindaca interroga una volta al giorno per lingua e non lo vedrà mai. Non c’è un tetto giornaliero né una quota da richiedere.

Esempi

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

curl -s "https://sigastra.com/api/v1/weekly?lang=it&sign=leo&full=1" | jq '.attribution.canonicalTag'

const res = await fetch("https://sigastra.com/api/v1/daily?lang=it&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

Le condizioni, per intero

Gratuito per qualsiasi sito, commerciale o no. Nessun account, nessuna chiave, nessun listino.
Mostra il link visibile “Powered by Sigastra”, do-follow, che punta al localizedHref che restituiamo.
Se pubblichi il testo INTEGRALE, aggiungi il canonicalTag dal payload nell’<head> di quella pagina.
Non presentare il contenuto come calcolato da te — è calcolato, e l’attribuzione è ciò che rende verificabile quell’affermazione.

FAQ sull’API

L’API oroscopo è davvero gratuita?+

Sì — nessun account, nessuna chiave, nessuna fattura, anche per siti commerciali. Le condizioni sono l’attribuzione e, per il testo integrale, un tag canonical.

Mi serve una chiave API?+

No. Gli endpoint funzionano senza chiave e sono limitati per frequenza sul bordo della rete. La forma della risposta porta già tutto ciò a cui una chiave si aggancerebbe in seguito, quindi aggiungerla non romperebbe la tua integrazione.

Qual è il limite di frequenza?+

10 richieste al secondo per IP con un picco di 30. Non c’è un tetto giornaliero.

Posso ripubblicare l’oroscopo intero?+

Sì, con full=1 — e allora devi aggiungere il tag canonical che ti dà il payload. Senza, due pagine identiche competono e un motore ne sceglie una; il canonical è ciò che impedisce che quella scelta sia un lancio di moneta.

Quali lingue copre l’API di astrologia?+

Quindici: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Nomi dei segni, dei pianeti, degli aspetti e delle fasi sono tutti localizzati.

I dati sono calcolati o scritti?+

Calcolati. Fase lunare e aspetti escono direttamente dalle effemeridi; il testo dell’oroscopo è generato ogni giorno dalle posizioni planetarie reali di quel giorno e messo in cache — l’API non genera mai su tua richiesta, legge ciò che c’è già.

Qui è tutto gratuito. L’unica condizione è un link do-follow visibile — più un tag canonical se pubblichi il testo integrale.

Widget →Syndication →WordPress →Panoramica →