概要ウィジェット配信APIWordPress
API
無料の星占い API

パートナー向け星占い・占星術データ API

パートナー向け星占い・占星術データ API

Sigastra を動かしているのと同じ高精度天文暦の上に構築された、読み取り専用の JSON API です。12 星座すべての日次・週次・月次の星占いを 15 言語で提供し、あわせて現在の月相、その日の惑星アスペクト、星座相性も返します。アカウント登録も請求もありません(サーバーからの呼び出しでは、ページのアドレスか無料キーでサイトを示します)。条件は出典表示ひとつ、そして全文を掲載する場合は canonical タグです。

試す

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

ブラウザから本番の API に対して実行します。CORS は開いているので、これはクライアント側実装の動く見本でもあります。

エンドポイント

GET /api/v1/dailylang, sign, full今日の星占い。12 星座すべて、または 1 星座。
GET /api/v1/weeklylang, sign, full今週分。期間キーと範囲ラベル付き。
GET /api/v1/monthlylang, sign, full今月分。
GET /api/v1/moonlang照らされている割合、月相、満ち欠けの向き、月の星座。天文暦そのもの。
GET /api/v1/cosmiclangその日の惑星同士の最も接近したアスペクトを、オーブ付きで。天文暦そのもの。
GET /api/v1/compatlang, a, b決定論的な星座相性。スコア、区分、エレメントとクオリティの関係。

パラメータ

lang
提供している 15 言語のいずれか（en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id）。それ以外はエラーではなく英語にフォールバックします。
sign
英語キー（leo）、英語スラッグ（leo）、またはその言語自身のスラッグ（shishi）。12 星座すべてを取得する場合は省略します。
full
full=1 は抜粋ではなく全文を返します。これが配信モードで、canonical の義務が有効になります。
a, b
compat 専用。受け付けているいずれかの形式で 2 つの星座を指定します。

抜粋か、全文か

既定では各項目に抜粋が付きます。カード、サイドバー、フィードの 1 行には十分な長さです。full=1 を加えると本文全体と、元ページに対応する sections オブジェクトが返ります。全文は再掲載のためのものなので、attribution オブジェクトは canonicalRequired を true に切り替え、貼り付けるべきタグをそのまま渡します。

レート制限

エッジで IP ごとに毎秒 10 リクエスト（バースト 30）、加えてアドレスごとに 1 日 1,500 リクエストの上限があります。12 星座を日刊・週刊・月刊で 1 日 4 回取得するパブリッシャーの消費はおよそ 150 件で、どちらの制限にも触れません。上限を超えると、このページへのリンクを含む HTTP 429 が返ります。さらに多くの量が必要な場合は info@sigastra.com までご連絡のうえ、掲載先をお知らせください。

例

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

Telegram チャンネルの設定手順

  1. sigastra.com/api/partners/verify?site=t.me/yourchannel を開きます。チャンネルは公開である必要があります。無料のキーはすぐに発行され、3日間のお試しは最初の呼び出しから始まります。
  2. ボットがキーを付けて API を呼び出し（例：/api/v1/daily?lang=ja&sign=leo&key=YOUR_KEY）、文章を投稿します（短縮や翻訳も可。規約をご確認ください）。
  3. 直近10件の投稿のうち少なくとも1件に、「Sigastra」という語を含む sigastra.com へのリンクを入れ、7日を超えて途切れないようにしてください。チャンネルの公開プレビューは自動で確認します。

API のよくある質問

星占い API は本当に無料ですか+

はい、商用・非商用を問わずどのサイトでも使えます。 最初の呼び出しから3日間はお試し期間です。その後はページが数時間ごとに自動で確認されます。リンクがなければコンテンツは一時停止し、リンクが再び確認されるとすぐに再開します。すぐに確認したい場合は sigastra.com/api/partners/verify?site=yourdomain.jp を開いてください。

API キーは必要ですか+

ブラウザからの呼び出し（ウィジェットや、ページ自身が API を呼ぶ場合）はページのアドレスを自動で送るため、ほかに何も必要ありません。サーバーからの呼び出しでは、どのサイト向けのコンテンツかを示してください。そのページのアドレスを Referer ヘッダーで送ります（当社の WordPress プラグインは自動でこれを行います）。サイトがリンク確認に合格すると、確認アドレスで無料のキーも受け取れます。2026年10月15日以降、どちらも送らないサーバーからの呼び出しは拒否されます。

レート制限はどれくらいですか+

エッジで IP ごとに毎秒 10 リクエスト（バースト 30）、加えてアドレスごとに 1 日 1,500 リクエストの上限があります。パブリッシャーの消費は 1 日およそ 150 件で、どちらにも触れません。上限超過時は HTTP 429 です。より多くの量が必要な場合は info@sigastra.com までご連絡ください。

星占いを全文そのまま再掲載できますか+

できます。full=1 を使い、そのうえで payload が渡す canonical タグを追加してください。これがないと同一の 2 ページが競合し、検索エンジンがどちらかを選びます。canonical はその選択をコイン投げでなくするためのものです。

占星術 API はどの言語に対応していますか+

15 言語です。en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id。星座名、惑星名、アスペクト名、月相名はいずれもローカライズされています。

データは計算されたものですか、書かれたものですか+

両方です。惑星の位置、月相、アスペクトは天体暦から計算します。星占いの文章は、その日に計算した位置をもとに AI（Anthropic の Claude）が1日1回書き、キャッシュに保存します。API はリクエストに応じて何かを書くことはなく、すでにあるものを読むだけです。

モバイルアプリで使えますか。+

ネイティブアプリでは使えません。このプログラムが無料なのは、リンクを載せた公開ページや公開チャンネルにコンテンツが置かれるからで、アプリにはそのどちらもありません。ウェブサイトや公開Telegramチャンネルなら問題ありません。それ以外は info@sigastra.com までご連絡ください。

ここにあるものはすべて無料です。条件は、見える リンク一本。全文を掲載する場合は canonical タグも併せてお願いします。

「無料」の仕組み

  • お試し期間は3日で、その間はリンクがなくても使えます。
  • 4日目から：コンテンツを表示するページに、ログイン不要で誰にでも見える、文字列に「Sigastra」を含む sigastra.com へのリンクを置いてください。日本語で構いません：「Powered by Sigastra」「占い提供：Sigastra」、あるいは「Sigastra」だけでも。ウィジェット枠の中ではなく、非表示にしないでください。rel="nofollow" を付けるかどうかは任意です。
  • リンクがない場合、すべての面（ウィジェット、画像、JSON）でコンテンツが停止し、応答に何を追加すべきかが明記されます。公開ページは自動で計測します。

リンクを置いたら /api/partners/verify?site=あなたのドメイン を開いてください。数分でコンテンツが再開します。リンクが計測され次第、無料のパートナーキーが自動発行されます。

利用規約の全文

ウィジェット →配信 →WordPress →概要 →