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 e nessuna fattura (le chiamate dal server indicano il tuo sito: indirizzo o chiave gratuita): l’unica condizione è l’attribuzione, e un tag canonical quando pubblichi il testo integrale.
Provalo
GET /api/v1/daily?lang=en&sign=leoGira 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 sul bordo della rete, picco di 30, e un tetto giornaliero di 1.500 richieste per indirizzo. Un editore che interroga dodici segni fra giornaliero, settimanale e mensile, quattro volte al giorno, ne consuma circa 150: non toccherà nessuno dei due limiti. Oltre il tetto la risposta è un HTTP 429 con un link a questa pagina. Serve più volume? Scriva a info@sigastra.com e ci dica dove esce il contenuto.
Esempi
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=it&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "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.canonicalTagCanali Telegram, passo per passo
- Apri sigastra.com/api/partners/verify?site=t.me/tuocanale. Il canale deve essere pubblico; ricevi subito la sua chiave gratuita, e la prova di tre giorni parte con la prima chiamata.
- Il tuo bot chiama l’API con la chiave, per esempio /api/v1/daily?lang=it&sign=leo&key=TUA_CHIAVE, e pubblica il testo (accorciato o tradotto va bene, vedi le condizioni).
- Almeno uno dei tuoi ultimi dieci post rimanda a sigastra.com con la parola “Sigastra”, senza un intervallo di più di sette giorni. Controlliamo automaticamente l’anteprima pubblica del canale.
FAQ sull’API
L’API oroscopo è davvero gratuita?+
Sì, su qualsiasi sito, commerciale o no. Hai tre giorni di prova dalla tua prima chiamata. Dopo, la tua pagina viene controllata automaticamente ogni poche ore: senza il link il contenuto si sospende, e torna appena il link viene misurato di nuovo. Per un controllo immediato apri sigastra.com/api/partners/verify?site=tuodominio.it.
Mi serve una chiave API?+
Le chiamate dal browser (i widget, o una pagina che interroga da sola l’API) inviano da sé l’indirizzo della pagina e non serve altro. Le chiamate dal tuo server devono dire per quale sito è il contenuto: invia l’indirizzo di quella pagina come intestazione Referer (il nostro plugin per WordPress lo fa per te). Quando il tuo sito supera il controllo del link, l’indirizzo di verifica ti dà anche una chiave gratuita. Dal 15 ottobre 2026 una chiamata dal server che non invia né l’uno né l’altra viene rifiutata.
Qual è il limite di frequenza?+
10 richieste al secondo per IP sul bordo della rete, picco di 30, più un tetto giornaliero di 1.500 richieste per indirizzo. Un editore ne consuma circa 150 al giorno e non tocca nessuno dei due. Oltre il tetto: HTTP 429: per più volume scriva a info@sigastra.com.
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?+
Entrambe le cose. Le posizioni dei pianeti, la fase lunare e gli aspetti sono calcolati dalle effemeridi. Il testo dell’oroscopo lo scrive una volta al giorno un’IA (Claude, di Anthropic) a partire dalle posizioni calcolate di quel giorno, poi viene salvato in cache: l’API non scrive mai nulla su tua richiesta, legge ciò che esiste già.
Posso usarlo in un’app per smartphone?+
Non in un’app nativa. Il programma è gratuito perché i contenuti stanno su una pagina o un canale pubblico che porta il link, e un’app non ha né l’una né l’altro. Un sito web o un canale Telegram pubblico vanno bene; per tutto il resto scrivi a info@sigastra.com.
Qui è tutto gratuito. L’unica condizione è un link visibile: più un tag canonical se pubblichi il testo integrale.
Come funziona il gratuito
- 3 giorni per provare: in quel periodo il link non è ancora richiesto.
- Dal giorno 4: un link visibile a sigastra.com il cui testo contenga la parola "Sigastra", nella pagina che mostra il contenuto, leggibile da chiunque senza login. La tua lingua va bene: "Powered by Sigastra", "Oroscopo di Sigastra" o solo "Sigastra". Non dentro il frame del widget e non nascosto. Aggiungere rel="nofollow" è una tua scelta.
- Senza, il contenuto si ferma su ogni superficie (widget, immagini, JSON) e la risposta dice esattamente cosa aggiungere. Misuriamo la tua pagina live automaticamente.
Link aggiunto? Apri /api/partners/verify?site=tuo-dominio.it e il contenuto riprende in pochi minuti. Una chiave partner gratuita viene assegnata al tuo sito automaticamente appena il link è misurato.