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 și fără factură (apelurile de pe server spun care e site-ul: adresa sau o cheie gratuită): singura condiție este atribuirea și o etichetă canonical atunci când publici textul integral.
Încearcă
GET /api/v1/daily?lang=en&sign=leoRulează 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/daily | lang, sign, full | Horoscopul de azi. Toate cele douăsprezece zodii sau una singură. |
GET /api/v1/weekly | lang, sign, full | Săptămâna curentă, cu cheia de perioadă și eticheta de interval. |
GET /api/v1/monthly | lang, sign, full | Luna curentă. |
GET /api/v1/moon | lang | Fracțiune iluminată, fază, în creștere/în descreștere, zodia Lunii. Efemeridă pură. |
GET /api/v1/cosmic | lang | Cele mai strânse aspecte planetă–planetă ale zilei, cu orbe. Efemeridă pură. |
GET /api/v1/compat | lang, a, b | Compatibilitate 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 la marginea rețelei, vârf de 30, și un plafon zilnic de 1.500 de cereri per adresă. Un editor care extrage douăsprezece semne pe zilnic, săptămânal și lunar, de patru ori pe zi, consumă în jur de 150, nu veți atinge niciuna dintre limite. Peste plafon răspunsul este HTTP 429, cu un link către această pagină. Aveți nevoie de mai mult volum? Scrieți la info@sigastra.com și spuneți-ne unde apare conținutul.
Exemple
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=ro&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "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.canonicalTagCanale de Telegram, pas cu pas
- Deschide sigastra.com/api/partners/verify?site=t.me/canalultau. Canalul trebuie să fie public; primești imediat cheia gratuită, iar perioada de probă de trei zile începe cu primul apel.
- Botul tău apelează API-ul cu cheia, de exemplu /api/v1/daily?lang=ro&sign=leo&key=CHEIA_TA, și publică textul (scurtat sau tradus este în regulă, vezi condițiile).
- Cel puțin una dintre ultimele tale zece postări are un link către sigastra.com cu cuvântul „Sigastra”, fără o pauză mai lungă de șapte zile. Verificăm automat previzualizarea publică a canalului.
Întrebări frecvente despre API
API-ul de horoscop este chiar gratuit?+
Da, pe orice site, comercial sau nu. Ai trei zile de probă de la primul apel. După aceea, pagina ta este verificată automat la câteva ore: fără link, conținutul se oprește și revine imediat ce linkul este măsurat din nou. Pentru o verificare pe loc, deschide sigastra.com/api/partners/verify?site=domeniultau.ro.
Am nevoie de o cheie API?+
Apelurile din browser (widgeturile sau o pagină care apelează singură API-ul) trimit singure adresa paginii și nu au nevoie de nimic altceva. Apelurile de pe serverul tău trebuie să spună pentru ce site este conținutul: trimite adresa acelei pagini în antetul Referer (pluginul nostru pentru WordPress face asta în locul tău). După ce site-ul tău trece verificarea linkului, adresa de verificare îți dă și o cheie gratuită. Din 15 octombrie 2026, un apel de pe server care nu trimite nici una, nici alta este refuzat.
Care este limita de rată?+
10 cereri pe secundă per IP la marginea rețelei, vârf de 30, plus un plafon zilnic de 1.500 de cereri per adresă. Un editor consumă în jur de 150 pe zi și nu atinge niciuna. Peste plafon: HTTP 429: pentru mai mult volum, scrieți la info@sigastra.com.
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?+
Ambele. Pozițiile planetelor, faza Lunii și aspectele sunt calculate din efemeride. Textul horoscopului este scris o dată pe zi de o inteligență artificială (Claude, de la Anthropic) din pozițiile calculate ale acelei zile și apoi păstrat în cache: API-ul nu scrie niciodată nimic la cererea ta, doar citește ce există deja.
Pot folosi acest conținut într-o aplicație mobilă?+
Nu într-o aplicație nativă. Programul este gratuit pentru că acest conținut stă pe o pagină sau pe un canal public care poartă linkul, iar o aplicație nu are niciuna dintre ele. Un site sau un canal public de Telegram sunt în regulă; pentru orice altceva, scrie la info@sigastra.com.
Totul aici este gratuit. Singura condiție este un link vizibil: plus o etichetă canonical dacă publici textul integral.
Cum funcționează „gratuit”
- 3 zile de testare: în acest timp linkul nu este încă necesar.
- Din ziua 4: un link vizibil către sigastra.com al cărui text conține cuvântul „Sigastra”, pe pagina care afișează conținutul, lizibil de oricine fără autentificare. Limba ta e bună: „Powered by Sigastra”, „Horoscop de la Sigastra” sau doar „Sigastra”. Nu în cadrul widgetului și nu ascuns. Dacă adaugi rel="nofollow" este alegerea ta.
- Fără el, conținutul se oprește pe toate suprafețele (widget, imagini, JSON), iar răspunsul spune exact ce trebuie adăugat. Măsurăm pagina ta live automat.
Ai pus linkul? Deschide /api/partners/verify?site=domeniul-tau.ro și conținutul revine în câteva minute. O cheie de partener gratuită este emisă site-ului tău automat imediat ce linkul este măsurat.