Dreams

Dream interpretation maps symbols from your dreams to psychological and spiritual meanings. Roxy has 2,500+ dream symbols with detailed interpretations. Your users care about this for dream journals, self-discovery, and pattern tracking.

New to fetch()? The Western Astrology guide has an annotated example explaining every line of an API call.

What you can build

• Dream journal apps — log dreams and see symbol interpretations
• Symbol lookup tools — search and browse 2,500+ dream symbols
• Daily features — daily dream symbol with meaning
• Pattern analysis — track recurring themes across dreams

Which endpoints to call

Symbol lookup

Look up any dream symbol by its ID (kebab-case, like "snake" or "being-chased"):

const response = await fetch('https://roxyapi.com/api/v2/dreams/symbols/water', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const symbol = await response.json();

Response:

{
  "id": "water",
  "name": "Water",
  "letter": "w",
  "meaning": "Water in dreams represents your emotional state and subconscious mind. Clear water suggests clarity and peace, while turbulent water indicates emotional turmoil..."
}

Which fields to show your users: name is the symbol title. meaning is the full interpretation text — display this as the main content. For a dream journal app, let users tag their entries with symbols and show the meaning alongside.

Search symbols

Search across all 2,500+ symbols by keyword:

const response = await fetch('https://roxyapi.com/api/v2/dreams/symbols?search=flying&limit=5', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const results = await response.json();
// results.total — how many matched
// results.symbols — array of { id, name, letter }

Use the id from search results to fetch the full meaning with the symbol lookup endpoint above.

Daily dream symbol

A random symbol each day for daily engagement features:

const response = await fetch('https://roxyapi.com/api/v2/dreams/daily', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({})
});
const daily = await response.json();
// daily.symbol.name, daily.symbol.meaning, daily.dailyMessage

Browse by letter

Get symbol counts by letter, useful for building an A-Z browse interface:

const response = await fetch('https://roxyapi.com/api/v2/dreams/symbols/letters', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
// data.letters — { a: 138, b: 282, ... }
// data.total — 2526

Then fetch symbols for a specific letter: /api/v2/dreams/symbols?letter=a&limit=20

Full API reference

See all Dreams endpoints in the API Reference.