API danych horoskopowych i astrologicznych dla partnerów
API JSON tylko do odczytu oparte na tych samych precyzyjnych efemerydach, na których działa Sigastra: horoskopy dzienne, tygodniowe i miesięczne dla wszystkich dwunastu znaków w piętnastu językach, a do tego bieżąca faza Księżyca, dzisiejsze aspekty planetarne i dopasowanie znaków. Bez konta i bez faktury (wywołania z serwera wskazują witrynę: adresem albo darmowym kluczem): jedynym warunkiem jest podanie źródła oraz znacznik canonical, gdy publikujesz pełny tekst.
Wypróbuj
GET /api/v1/daily?lang=en&sign=leoDziała na żywym API prosto z twojej przeglądarki. CORS jest otwarty, więc to jednocześnie działający przykład integracji po stronie klienta.
Punkty końcowe
GET /api/v1/daily | lang, sign, full | Dzisiejszy horoskop. Wszystkie dwanaście znaków albo jeden. |
GET /api/v1/weekly | lang, sign, full | Bieżący tydzień, z kluczem okresu i etykietą zakresu. |
GET /api/v1/monthly | lang, sign, full | Bieżący miesiąc. |
GET /api/v1/moon | lang | Oświetlona część, faza, przybywający/ubywający, znak Księżyca. Czysta efemeryda. |
GET /api/v1/cosmic | lang | Najciaśniejsze aspekty planeta–planeta danego dnia, z orbisami. Czysta efemeryda. |
GET /api/v1/compat | lang, a, b | Deterministyczne dopasowanie znaków: wynik, przedział, relacja żywiołu i jakości. |
Parametry
- lang
- Jeden z piętnastu obsługiwanych języków (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Wszystko inne przechodzi na angielski zamiast zwracać błąd.
- sign
- Angielski klucz (leo), angielski slug (leo) albo własny slug danego języka (lew). Pomiń dla wszystkich dwunastu.
- full
- full=1 zwraca pełny tekst zamiast zajawki. To tryb dystrybucji i włącza obowiązek canonical.
- a, b
- Tylko dla compat. Dwa znaki, w dowolnej z akceptowanych postaci.
Zajawka albo pełny tekst
Domyślnie każdy element niesie zajawkę: tyle, by wypełnić kartę, pasek boczny albo wiersz kanału. Dodaj full=1, a dostaniesz pełną treść oraz obiekt sections odpowiadający stronie źródłowej. Pełny tekst jest przeznaczony do ponownej publikacji, więc obiekt attribution przestawia canonicalRequired na true i podaje ci dokładny znacznik do wklejenia.
Limit zapytań
10 zapytań na sekundę na adres IP na brzegu sieci, skok do 30, oraz dzienny limit 1500 zapytań na adres. Wydawca pobierający dwanaście znaków w wariancie dziennym, tygodniowym i miesięcznym, cztery razy dziennie, zużywa około 150: żadnego z tych limitów nie dotknie. Powyżej limitu odpowiedzią jest HTTP 429 z odnośnikiem do tej strony. Potrzebny większy wolumen? Proszę napisać na info@sigastra.com i wskazać, gdzie treść jest publikowana.
Przykłady
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=pl&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "https://sigastra.com/api/v1/weekly?lang=pl&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=pl&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.canonicalTagKanały na Telegramie krok po kroku
- Otwórz sigastra.com/api/partners/verify?site=t.me/twojkanal. Kanał musi być publiczny; od razu dostajesz jego darmowy klucz, a trzydniowy okres próbny zaczyna się od pierwszego wywołania.
- Twój bot wywołuje API z kluczem, na przykład /api/v1/daily?lang=pl&sign=leo&key=TWOJ_KLUCZ, i publikuje tekst (skrócony lub przetłumaczony jest w porządku, zobacz warunki).
- Co najmniej jeden z Twoich ostatnich dziesięciu postów zawiera link do sigastra.com ze słowem „Sigastra”, bez przerwy dłuższej niż siedem dni. Publiczny podgląd kanału sprawdzamy automatycznie.
API: najczęstsze pytania
Czy API horoskopu jest naprawdę darmowe?+
Tak, na dowolnej stronie, komercyjnej lub nie. Od pierwszego wywołania masz trzy dni na testy. Potem Twoja strona jest automatycznie sprawdzana co kilka godzin: bez linku treść zostaje wstrzymana i wraca, gdy tylko link zostanie ponownie zmierzony. Aby sprawdzić od razu, otwórz sigastra.com/api/partners/verify?site=twojadomena.pl.
Czy potrzebuję klucza API?+
Wywołania z przeglądarki (widżety albo strona, która sama odpytuje API) same wysyłają adres swojej strony i nie potrzebują niczego więcej. Wywołania z Twojego serwera muszą wskazać, dla której witryny jest treść: wyślij adres tej strony w nagłówku Referer (nasza wtyczka do WordPressa robi to za Ciebie). Gdy Twoja witryna przejdzie sprawdzenie linku, pod adresem weryfikacji dostaniesz też darmowy klucz. Od 15 października 2026 r. wywołanie z serwera, które nie wysyła ani jednego, ani drugiego, jest odrzucane.
Jaki jest limit zapytań?+
10 zapytań na sekundę na adres IP na brzegu sieci, skok do 30, oraz dzienny limit 1500 zapytań na adres. Wydawca zużywa około 150 dziennie, więc nie dotknie żadnego z nich. Powyżej: HTTP 429: po większy wolumen proszę napisać na info@sigastra.com.
Czy mogę opublikować cały horoskop ponownie?+
Tak, z full=1, i wtedy musisz dodać znacznik canonical, który daje ci payload. Bez niego dwie identyczne strony rywalizują, a wyszukiwarka wybiera jedną; canonical sprawia, że ten wybór przestaje być rzutem monetą.
Jakie języki obejmuje API astrologiczne?+
Piętnaście: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Nazwy znaków, planet, aspektów i faz są zlokalizowane.
Czy dane są obliczane, czy pisane?+
Jedno i drugie. Pozycje planet, faza Księżyca i aspekty są obliczane z efemeryd. Tekst horoskopu raz dziennie pisze AI (Claude od Anthropic) na podstawie obliczonych pozycji z tego dnia, a potem trafia do pamięci podręcznej: API nigdy nic nie pisze na Twoje żądanie, tylko czyta to, co już istnieje.
Czy mogę użyć tego w aplikacji mobilnej?+
Nie w aplikacji natywnej. Program jest darmowy, bo treść stoi na publicznej stronie albo w publicznym kanale z linkiem, a aplikacja nie ma ani jednego, ani drugiego. Strona internetowa lub publiczny kanał na Telegramie są w porządku; w pozostałych sprawach napisz na info@sigastra.com.
Wszystko tutaj jest darmowe. Jedyny warunek to widoczny link: plus tag kanoniczny, jeśli publikujesz pełny tekst.
Jak działa „za darmo”
- 3 dni na testy: w tym czasie link nie jest jeszcze wymagany.
- Od 4. dnia: widoczny link do sigastra.com, którego tekst zawiera słowo „Sigastra”, na stronie, która pokazuje treść, czytelny dla każdego bez logowania. Twój język jest w porządku: „Powered by Sigastra”, „Horoskop od Sigastry” albo po prostu „Sigastra”. Nie w ramce widżetu i nie ukryty. Dodanie rel="nofollow" to Twój wybór.
- Bez niego treść zostaje wstrzymana na każdej powierzchni (widżet, obrazy, JSON), a odpowiedź mówi dokładnie, co dodać. Twoją stronę mierzymy automatycznie.
Link dodany? Otwórz /api/partners/verify?site=twoja-domena.pl, a treść wróci w kilka minut. Darmowy klucz partnera jest wydawany Twojej stronie automatycznie, gdy tylko link zostanie zmierzony.