API data horoskop dan astrologi untuk mitra
API JSON hanya-baca di atas efemeris presisi tinggi yang sama yang menjalankan Sigastra: horoskop harian, mingguan, dan bulanan untuk seluruh dua belas zodiak dalam lima belas bahasa, ditambah fase Bulan terkini, aspek planet hari ini, dan kecocokan zodiak. Tanpa akun dan tanpa tagihan (panggilan dari server menyebutkan situsnya: alamat atau kunci gratis): satu-satunya syarat adalah atribusi, dan tag canonical saat kamu menerbitkan teks penuh.
Coba
GET /api/v1/daily?lang=en&sign=leoBerjalan pada API langsung dari peramban kamu. CORS terbuka, jadi ini sekaligus contoh integrasi sisi klien yang berfungsi.
Endpoint
GET /api/v1/daily | lang, sign, full | Horoskop hari ini. Seluruh dua belas zodiak, atau satu saja. |
GET /api/v1/weekly | lang, sign, full | Minggu berjalan, dengan kunci periode dan label rentangnya. |
GET /api/v1/monthly | lang, sign, full | Bulan berjalan. |
GET /api/v1/moon | lang | Bagian yang tersinari, fase, membesar/menyusut, zodiak Bulan. Efemeris murni. |
GET /api/v1/cosmic | lang | Aspek planet-ke-planet paling rapat hari itu, lengkap dengan orbnya. Efemeris murni. |
GET /api/v1/compat | lang, a, b | Kecocokan zodiak deterministik: skor, rentang, hubungan elemen dan modalitas. |
Parameter
- lang
- Salah satu dari lima belas bahasa yang dilayani (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Selain itu jatuh ke bahasa Inggris alih-alih memberi galat.
- sign
- Kunci Inggris (leo), slug Inggris (leo), atau slug bahasa itu sendiri (leo). Kosongkan untuk seluruh dua belas.
- full
- full=1 mengembalikan teks lengkap alih-alih cuplikan. Ini mode sindikasi dan menyalakan kewajiban canonical.
- a, b
- Khusus compat. Dua zodiak, dalam bentuk apa pun yang diterima.
Cuplikan atau teks penuh
Secara bawaan setiap item membawa cuplikan: cukup untuk sebuah kartu, bilah samping, atau baris umpan. Tambahkan full=1 dan kamu mendapat isi lengkap, plus objek sections yang sesuai dengan halaman sumber. Teks penuh ditujukan untuk diterbitkan ulang, jadi objek attribution mengubah canonicalRequired menjadi true dan memberimu tag persisnya untuk ditempel.
Batas laju
10 permintaan per detik per IP di tepi jaringan, lonjakan 30, dan plafon harian 1.500 permintaan per alamat. Penerbit yang menarik dua belas zodiak untuk harian, mingguan, dan bulanan, empat kali sehari, menghabiskan sekitar 150: Anda tidak akan menyentuh keduanya. Di atas plafon, jawabannya HTTP 429 dengan tautan ke halaman ini. Butuh volume lebih? Kirim surel ke info@sigastra.com dan beri tahu kami di mana konten itu 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/kanalmu. Kanal harus publik; kamu langsung mendapat kunci gratisnya, dan masa coba tiga hari dimulai dengan panggilan pertama.
- Bot-mu memanggil API dengan kunci, misalnya /api/v1/daily?lang=id&sign=leo&key=KUNCIMU, lalu mengunggah teksnya (boleh dipersingkat atau diterjemahkan, lihat ketentuan).
- Setidaknya satu dari sepuluh unggahan terakhirmu memuat tautan ke sigastra.com dengan kata “Sigastra”, tanpa jeda 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. Kamu mendapat masa coba tiga hari sejak panggilan pertama. Setelah itu halamanmu diperiksa otomatis setiap beberapa jam: tanpa tautan, konten berhenti, dan kembali begitu tautan terukur lagi. Untuk memeriksa saat itu juga, buka sigastra.com/api/partners/verify?site=domainmu.id.
Apakah saya butuh kunci API?+
Panggilan dari peramban (widget, atau halaman yang memanggil API sendiri) mengirim alamat halamannya dengan sendirinya dan tidak memerlukan apa pun lagi. Panggilan dari servermu harus menyebutkan untuk situs mana kontennya: kirim alamat halaman itu sebagai header Referer (plugin WordPress kami melakukannya untukmu). Setelah situsmu lolos pemeriksaan tautan, alamat verifikasi juga memberimu kunci gratis. Mulai 15 Oktober 2026, panggilan server yang tidak mengirim keduanya akan ditolak.
Berapa batas lajunya?+
10 permintaan per detik per IP di tepi jaringan, lonjakan 30, plus plafon harian 1.500 permintaan per alamat. Penerbit menghabiskan sekitar 150 per hari, jadi tidak menyentuh keduanya. Di atas plafon: HTTP 429: untuk volume lebih, kirim surel ke info@sigastra.com.
Bolehkah saya menerbitkan ulang seluruh horoskop?+
Boleh, dengan full=1, dan saat itu kamu harus menambahkan tag canonical yang diberikan payload. Tanpa itu, dua halaman identik bersaing dan mesin pencari memilih salah satu; canonical yang membuat pilihan itu berhenti menjadi lemparan koin.
Bahasa apa saja yang dicakup API astrologi?+
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 dilokalkan.
Datanya dihitung atau ditulis?+
Keduanya. Posisi planet, fase Bulan, dan aspek dihitung dari efemeris. Teks horoskop ditulis sekali sehari oleh AI (Claude, buatan Anthropic) dari posisi hasil hitungan hari itu, lalu disimpan di cache: API tidak pernah menulis apa pun atas permintaanmu, ia hanya membaca yang sudah ada.
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. Satu-satunya syarat adalah tautan yang terlihat: plus tag canonical bila kamu menerbitkan teks penuh.
Cara kerja "gratis"
- 3 hari untuk mencoba: selama itu tautan belum diperlukan.
- Mulai hari ke-4: tautan yang terlihat ke sigastra.com yang teksnya memuat kata "Sigastra", di halaman yang menampilkan konten, bisa dibaca siapa pun tanpa login. Bahasamu sendiri boleh: "Powered by Sigastra", "Horoskop oleh Sigastra", atau cukup "Sigastra". Bukan di dalam bingkai widget dan tidak disembunyikan. Menambahkan rel="nofollow" adalah pilihanmu.
- Tanpa itu konten berhenti di semua permukaan (widget, gambar, JSON) dan respons menyebutkan persis apa yang harus ditambahkan. Kami mengukur halaman live kamu secara otomatis.
Sudah pasang tautannya? Buka /api/partners/verify?site=domain-kamu.id dan konten kembali dalam beberapa menit. Kunci partner gratis diterbitkan untuk situsmu secara otomatis begitu tautan terukur.