API data horoskop dan astrologi untuk mitra
API JSON hanya-baca yang memakai efemeris yang sama dengan Sigastra: horoskop harian, mingguan, dan bulanan untuk dua belas zodiak dalam lima belas bahasa, ditambah fase Bulan, aspek planet hari ini, dan kecocokan zodiak. Tidak ada akun dan tidak ada tagihan. Panggilan dari server cukup menyebutkan situsnya, lewat alamat halaman atau kunci gratis. Syaratnya hanya atribusi, ditambah tag canonical kalau Anda menerbitkan teks penuh.
Coba
GET /api/v1/daily?lang=en&sign=leoPermintaan ini dijalankan ke API langsung dari peramban Anda. CORS terbuka, jadi ini sekaligus contoh integrasi sisi klien yang berfungsi.
Endpoint
GET /api/v1/daily | lang, sign, full | Horoskop hari ini, untuk dua belas zodiak atau satu saja. |
GET /api/v1/weekly | lang, sign, full | Minggu berjalan, lengkap dengan kunci periode dan label rentang tanggalnya. |
GET /api/v1/monthly | lang, sign, full | Bulan berjalan. |
GET /api/v1/moon | lang | Persentase terang, fase, membesar atau mengecil, dan zodiak Bulan. Murni dari efemeris. |
GET /api/v1/cosmic | lang | Aspek antarplanet paling rapat hari ini, beserta orbnya. Murni dari efemeris. |
GET /api/v1/compat | lang, a, b | Kecocokan zodiak yang selalu sama untuk pasangan yang sama: skor, rentang, serta hubungan elemen dan modalitas. |
Parameter
- lang
- Salah satu dari lima belas bahasa yang tersedia (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Nilai lain otomatis jatuh ke bahasa Inggris, bukan galat.
- sign
- Kunci Inggris (leo), slug Inggris (leo), atau slug bahasa itu (leo). Kosongkan untuk dua belas zodiak sekaligus.
- full
- full=1 mengembalikan teks lengkap, bukan cuplikan. Ini mode sindikasi, dan sekaligus mewajibkan tag canonical.
- a, b
- Khusus compat. Dua zodiak dalam format apa pun yang diterima.
Cuplikan atau teks penuh
Secara bawaan, setiap item berisi cuplikan, cukup untuk kartu, sidebar, atau satu baris di feed. Dengan full=1, Anda mendapat isi lengkap beserta objek sections yang sama dengan halaman sumber. Teks penuh dimaksudkan untuk diterbitkan ulang, jadi objek attribution mengubah canonicalRequired menjadi true dan menyertakan tag yang tinggal ditempel.
Batas laju
10 permintaan per detik per IP di tepi jaringan, lonjakan sampai 30, dan batas harian 1.500 permintaan per alamat. Penerbit yang menarik dua belas zodiak untuk harian, mingguan, dan bulanan, empat kali sehari, hanya memakai sekitar 150. Melewati batas, respons berupa HTTP 429 dengan tautan ke halaman ini. Butuh volume lebih besar? Kirim email ke info@sigastra.com dan ceritakan di mana konten itu akan tayang.
Contoh
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=id&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "https://sigastra.com/api/v1/weekly?lang=id&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=id&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.canonicalTagKanal Telegram, langkah demi langkah
- Buka sigastra.com/api/partners/verify?site=t.me/kanalanda. Kanal harus publik. Anda langsung mendapat kunci gratis, dan masa coba tiga hari dimulai sejak panggilan pertama.
- Bot Anda memanggil API dengan kunci, misalnya /api/v1/daily?lang=id&sign=leo&key=KUNCIANDA, lalu mengunggah teksnya (boleh dipersingkat atau diterjemahkan, lihat ketentuan).
- Setidaknya satu dari sepuluh unggahan terakhir memuat tautan ke sigastra.com dengan kata “Sigastra”, dan jedanya tidak lebih dari tujuh hari. Kami memeriksa pratinjau publik kanal secara otomatis.
Tanya jawab API
Apakah API horoskop benar-benar gratis?+
Ya, di situs mana pun, komersial atau bukan. Anda mendapat masa percobaan tiga hari sejak panggilan pertama. Setelah itu halaman Anda diperiksa otomatis setiap beberapa jam: kalau tautannya tidak ada, konten berhenti tampil, dan muncul lagi begitu tautan terdeteksi. Untuk memeriksa saat itu juga, buka sigastra.com/api/partners/verify?site=domainanda.id.
Apakah saya butuh kunci API?+
Panggilan dari peramban (widget, atau halaman yang memanggil API sendiri) otomatis mengirim alamat halamannya dan tidak perlu apa-apa lagi. Panggilan dari server Anda harus menyebutkan situs mana yang memakai kontennya: kirim alamat halaman itu sebagai header Referer (plugin WordPress kami melakukannya otomatis). Setelah tautan Anda terdeteksi, alamat verifikasi juga memberi kunci gratis. Mulai 15 Oktober 2026, panggilan server tanpa salah satu dari keduanya akan ditolak.
Berapa batas lajunya?+
10 permintaan per detik per IP, lonjakan sampai 30, dan batas harian 1.500 permintaan per alamat. Rata-rata penerbit memakai sekitar 150 per hari. Di atas batas, respons berupa HTTP 429. Untuk volume lebih besar, email info@sigastra.com.
Bolehkah saya menerbitkan ulang horoskop secara utuh?+
Boleh, dengan full=1, asalkan Anda menambahkan tag canonical dari payload. Tanpa itu, dua halaman yang identik akan bersaing, dan mesin pencari terpaksa memilih salah satunya.
Bahasa apa saja yang tersedia?+
Lima belas: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Nama zodiak, planet, aspek, dan fase semuanya dalam bahasa yang dipilih.
Datanya dihitung atau ditulis?+
Keduanya. Posisi planet, fase Bulan, dan aspek dihitung dengan efemeris. Teks horoskop ditulis sekali sehari oleh AI (Claude, buatan Anthropic) berdasarkan posisi yang sudah dihitung, lalu disimpan di cache. API tidak menulis apa pun saat dipanggil, hanya membaca yang sudah tersedia.
Bolehkah saya memakainya di aplikasi seluler?+
Tidak di aplikasi native. Program ini gratis karena kontennya berada di halaman atau kanal publik yang memuat tautan, sedangkan aplikasi tidak punya keduanya. Situs web atau kanal Telegram publik boleh; untuk hal lain, tulis ke info@sigastra.com.
Semua di sini gratis. Syaratnya hanya tautan yang terlihat, ditambah tag canonical kalau Anda menerbitkan teks penuh.
Cara kerja "gratis"
- 3 hari untuk mencoba: selama masa itu tautan belum diperlukan.
- Mulai hari ke-4: harus ada tautan yang terlihat ke sigastra.com dengan teks yang memuat kata "Sigastra", di halaman yang menampilkan konten, dan bisa dibaca siapa pun tanpa login. Teksnya boleh dalam bahasa Anda: "Powered by Sigastra", "Horoskop oleh Sigastra", atau cukup "Sigastra". Tidak di dalam iframe widget dan tidak disembunyikan. Memakai rel="nofollow" boleh, itu pilihan Anda.
- Tanpa tautan itu, konten berhenti di semua jalur (widget, gambar, JSON), dan responsnya menjelaskan apa yang perlu ditambahkan. Kami memeriksa halaman Anda secara otomatis.
Tautan sudah dipasang? Buka /api/partners/verify?site=domain-anda.id, dan konten aktif lagi dalam beberapa menit. Kunci mitra gratis diterbitkan otomatis begitu tautan Anda terdeteksi.

