無料の星占い API

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

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

試す

full=1

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

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

エンドポイント

`GET /api/v1/daily`	lang, sign, full	今日の星占い。12 星座すべて、または 1 星座。
`GET /api/v1/weekly`	lang, sign, full	今週分。期間キーと範囲ラベル付き。
`GET /api/v1/monthly`	lang, sign, full	今月分。
`GET /api/v1/moon`	lang	照らされている割合、月相、満ち欠けの向き、月の星座。天文暦そのもの。
`GET /api/v1/cosmic`	lang	その日の惑星同士の最も接近したアスペクトを、オーブ付きで。天文暦そのもの。
`GET /api/v1/compat`	lang, 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 回取得するだけなので、この制限に触れることはありません。日次上限も、申請すべきクォータもありません。

例

curl -s "https://sigastra.com/api/v1/daily?lang=ja&sign=leo" | jq .

curl -s "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

利用条件の全文

商用・非商用を問わず、あらゆるサイトで無料です。アカウントもキーも料金表もありません。
返却する localizedHref を指す「Powered by Sigastra」リンクを、do-follow で目に見える形で表示してください。
全文を掲載する場合は、payload の canonicalTag をそのページの <head> に追加してください。
コンテンツをあなたが計算したものとして提示しないでください。これは計算されたものであり、出典表示こそがその主張を検証可能にします。

API のよくある質問

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

はい。アカウントもキーも請求もなく、商用サイトでも同じです。条件は出典表示と、全文の場合は canonical タグです。

API キーは必要ですか+

いりません。エンドポイントはキー不要で、代わりにエッジでレート制限されています。レスポンスの形はキーが後から結び付くものをすでにすべて備えているため、将来キーを導入しても実装は壊れません。

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

IP ごとに毎秒 10 リクエスト、バースト 30 です。日次上限はありません。

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

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

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

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

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

計算されたものです。月相とアスペクトは天文暦から直接得ています。星占いの文章はその日の実際の惑星位置から毎日生成してキャッシュしており、API があなたのリクエストで生成することはありません。すでにあるものを読むだけです。

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

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