Saju API › Dream Interpretation API

Dream Interpretation API

Send a dream description and get, as JSON, the symbol words found in a dream symbol glossary that HRUM built itself, most prominent first. The product is called "Dream Interpretation". The glossary holds words only — no dream meanings and no good-or-bad judgments. The same input always gives the same result.

Get Started guide Playground Pricing

What it returns

• Symbol words — only words that actually appear in the dream, as the word itself, a synonym or an inflected form; up to 40 (items[].keywords)
• Prominence score — 0 to 1, equal or decreasing down the list (items[].score)
• Match mode — whether the words were found in the glossary or no symbol was found (mode)

When no symbol is found

If no symbol is found, items comes back as an empty array and nothing is charged.

If you need reading sentences

The response has no reading sentences. Pass the dream and the words found to the Saju Interpretation API (only: "dream") or to an LLM API as input.

Request example

{
  "dream": "바다에서 커다란 물고기를 두 손으로 잡는 꿈을 꿨어요"
}

Authentication uses the X-Partner-Api-Key header, and the base URL is https://api.hrum.ai/api/v1/partners/v1. Python and JavaScript examples and error handling are in the Get Started guide.

Response example

{
  "success": true,
  "data": {
    "lang": "ko",
    "mode": "glossary",
    "items": [
      { "keywords": ["바다"], "score": 1 },
      { "keywords": ["물고기"], "score": 0.979 },
      { "keywords": ["손"], "score": 0.749 }
    ]
  }
}

Pricing

Dream Interpretation costs ₩30 per call (excl. VAT; ₩33 incl. VAT). You are charged only when at least one item is found; an empty result is not deducted. Only successful calls are deducted from prepaid credits; 4xx and 5xx error responses are not charged.

Store a result once you have it, and reuse it. Sending the same request again is charged again. The same birth date and time with the same options always gives the same result, so save the first response in your database (for example, keyed by a hash of the request body) and use the saved value from then on at no cost. For results that change by date, such as a daily fortune, include the date in the key and reuse the result for that day only.

Full pricing

Full reference

The full parameter table, response field descriptions and error codes are in the reference: Dream Interpretation API reference. Other Saju products are listed under All Saju APIs.

Contact: contact@float.do · Operated by FLOAT Co., Ltd.