コンテンツにスキップ

3枚のカードによるタロット占い

3枚のカードによるタロット占いは、あなたの過去、現在、そして未来に関する洞察を提供します。 この占いは、名前と生年月日を使用してパーソナライズされた、影響、課題、およびガイダンスを表す3枚のカードを引きます。

この占いを活用して、明確さを得る、パターンを振り返り、今後のサイクルに備えることができます。


エンドポイント

メソッド パス
GET https://api.numerologyapi.com/api/v1/tarot/reading
POST https://api.numerologyapi.com/api/v1/tarot/reading

必要なヘッダー

X-API-Key: YOUR_API_KEY
Content-Type: application/json   (POST only)
Host: api.numerologyapi.com

また、Authorization: Bearer YOUR_API_KEYを使用して認証することも可能です。 Numerology APIダッシュボードでAPIキーを作成および管理できます。| パラメータ | 型 | 必須 | 説明 | | ------ | ------ | -------- | ----------------------------------------------------------------------------------------------- | | name | 文字列 | はい | あなたのフルネーム。リーディングをパーソナライズするために使用されます。 | | dob | 文字列 | はい | 生年月日をYYYY-MM-DD形式で入力してください。 | | mode | 文字列 | いいえ | random (デフォルト) または daily。 毎日モードでは、同じ日付で同じカードが出るようにします。 |

レスポンスをローカライズするために、オプションのlangクエリパラメータを追加してください。 サポートされている値: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh。

サンプルリクエスト

GET リクエスト

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?name=John+Doe&dob=1992-07-16&mode=random&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST リクエスト (JSONボディ)

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "John Doe",
  "dob": "1992-07-16",
  "mode": "random"
}'

レスポンスの例
{
  "status": "success",
  "mode": "random",
  "name": "john doe",
  "dob": "1992-07-16",
  "timestamp": "2026-08-18T00:05:59.013552",
  "reading": [
    {
      "position": "past",
      "card": "Wheel of Fortune",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909507/10-WheelOfFortune_fokxki.png",
      "meaning": "The Wheel of Fortune represents fate, cycles, and unexpected change. Upright, it signals a turning point—often in your favor—and encourages you to embrace life’s ups and downs with faith. This card highlights karma, luck, and the interconnectedness of all things. Trust the universe’s rhythm and stay adaptable."
    },
    {
      "position": "present",
      "card": "The Devil",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/15-TheDevil_ztmvio.png",
      "meaning": "The Devil card highlights temptation, addiction, and material bondage. Upright, it reveals areas where you feel trapped or powerless—often by your own desires or fears. It challenges you to confront unhealthy attachments and reclaim your autonomy. Awareness is the first step toward liberation."
    },
    {
      "position": "future",
      "card": "Six of Pentacles",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909583/Pentacles06_REVERSED_ccxi5g.png",
      "meaning": "Reversed, the Six of Pentacles may indicate inequality, strings attached to help, or financial imbalance. Beware of hidden motives or unhealthy dependencies in relationships or money matters."
    }
  ],
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "e7d2f5dafe249067",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "endpoint_name": "tarot_reading",
    "endpoint_description": "Generates a tarot card reading with interpretations and guidance.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-08-18T01:05:59.033692+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "fr",
      "es",
      "de",
      "pt",
      "ja",
      "hi",
      "ar",
      "ru",
      "tr",
      "it",
      "pl",
      "nl",
      "id",
      "ko",
      "th",
      "ro",
      "ur",
      "gu",
      "bn",
      "vi",
      "ta",
      "te",
      "mr",
      "pa",
      "zh"
    ],
    "notes": ""
  }
}

ダッシュボードを開く


!!! 注意 mode=daily は、氏名、生年月日、および現在の日付に基づいてカードの引きを決定し、一貫した毎日のガイダンスを提供します。 * 各カードの reversed のステータスは、解釈を変更する可能性があります。 * image_url はカードのイラストを提供し、card_backcover は一般的な逆向きのカードです。 * カードは 過去 → 現在 → 未来* の順で返されます。


関連するエンドポイント