API de horoscop gratuit

API cu date de horoscop și astrologie pentru parteneri

Un API JSON doar pentru citire peste aceleași efemeride de precizie pe care rulează Sigastra: horoscoape zilnice, săptămânale și lunare pentru toate cele douăsprezece zodii în cincisprezece limbi, plus faza Lunii în timp real, aspectele planetare de azi și compatibilitatea zodiilor. Fără cont, fără cheie, fără factură — singura condiție este atribuirea și o etichetă canonical atunci când publici textul integral.

Încearcă

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

Rulează pe API-ul live direct din browserul tău. CORS este deschis, deci acesta este totodată un exemplu funcțional de integrare pe partea de client.

Puncte de acces

GET /api/v1/dailylang, sign, fullHoroscopul de azi. Toate cele douăsprezece zodii sau una singură.
GET /api/v1/weeklylang, sign, fullSăptămâna curentă, cu cheia de perioadă și eticheta de interval.
GET /api/v1/monthlylang, sign, fullLuna curentă.
GET /api/v1/moonlangFracțiune iluminată, fază, în creștere/în descreștere, zodia Lunii. Efemeridă pură.
GET /api/v1/cosmiclangCele mai strânse aspecte planetă–planetă ale zilei, cu orbe. Efemeridă pură.
GET /api/v1/compatlang, a, bCompatibilitate deterministă a zodiilor: scor, interval, relația de element și de calitate.

Parametri

lang
Una dintre cele cincisprezece limbi servite (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Orice altceva cade pe engleză în loc să dea eroare.
sign
Cheia engleză (leo), slugul englez (leo) sau slugul propriu al limbii (leu). Omite-l pentru toate douăsprezece.
full
full=1 returnează textul complet în loc de un fragment. Este modul de sindicalizare și activează obligația canonical.
a, b
Doar pentru compat. Două zodii, în oricare dintre formele acceptate.

Fragment sau text integral

Implicit, fiecare element poartă un fragment — suficient pentru un card, o bară laterală sau un rând de flux. Adaugă full=1 și primești corpul complet, plus un obiect sections care corespunde paginii sursă. Textul integral este gândit pentru republicare, așa că obiectul attribution trece canonicalRequired pe true și îți dă eticheta exactă de lipit.

Limită de rată

10 cereri pe secundă per IP, cu un vârf de 30, aplicată la marginea rețelei. Un partener care sindicalizează extrage o dată pe zi pe limbă și nu o va vedea niciodată. Nu există plafon zilnic și nici cotă de solicitat.

Exemple

curl -s "https://sigastra.com/api/v1/daily?lang=ro&sign=leo" | jq .
curl -s "https://sigastra.com/api/v1/weekly?lang=ro&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=ro&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

Condițiile, integral

  • Gratuit pentru orice site, comercial sau nu. Fără cont, fără cheie, fără grilă de tarife.
  • Afișează linkul vizibil „Powered by Sigastra”, do-follow, care duce către localizedHref-ul pe care îl returnăm.
  • Dacă publici textul INTEGRAL, adaugă canonicalTag din payload în <head>-ul acelei pagini.
  • Nu prezenta conținutul ca fiind calculat de tine — este calculat, iar atribuirea este ceea ce face acea afirmație verificabilă.

Întrebări frecvente despre API

API-ul de horoscop este chiar gratuit?+

Da — fără cont, fără cheie, fără factură, inclusiv pentru site-uri comerciale. Condițiile sunt atribuirea și, pentru textul integral, o etichetă canonical.

Am nevoie de o cheie API?+

Nu. Punctele de acces funcționează fără cheie și sunt limitate ca rată la marginea rețelei. Forma răspunsului poartă deja tot ce s-ar atașa ulterior unei chei, așa că adăugarea uneia nu ți-ar strica integrarea.

Care este limita de rată?+

10 cereri pe secundă per IP, cu un vârf de 30. Nu există plafon zilnic.

Pot republica horoscopul întreg?+

Da, cu full=1 — și atunci trebuie să adaugi eticheta canonical pe care ți-o dă payloadul. Fără ea, două pagini identice concurează și un motor alege una; canonical este ceea ce împiedică acea alegere să fie dat cu banul.

Ce limbi acoperă API-ul de astrologie?+

Cincisprezece: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Numele zodiilor, planetelor, aspectelor și fazelor sunt toate localizate.

Datele sunt calculate sau scrise?+

Calculate. Faza Lunii și aspectele vin direct din efemeridă; textul horoscopului este generat zilnic din pozițiile planetare reale ale acelei zile și pus în cache — API-ul nu generează niciodată la cererea ta, citește ce există deja.

Totul aici este gratuit. Singura condiție este un link do-follow vizibil — plus o etichetă canonical dacă publici textul integral.