Dream interpretation API guide

Ship a dream journal, a symbol lookup tool, or an AI dream-interpretation chatbot. Thousands of symbols included.

dream meaning is among the highest-volume spiritual searches on Google. Every "what does it mean to dream about X" page maps to a single endpoint here. RoxyAPI ships 2,200+ dream symbols with psychological and spiritual interpretations, searchable, browsable A to Z.

What you can build

• Dream journal apps that tag entries with symbols and show meanings
• Symbol lookup tools (pure content SEO surface)
• AI dream-interpretation chatbots
• Daily dream-symbol widgets for journaling apps

Prerequisites

1. A RoxyAPI key. Get your API key.
2. Symbol lookup uses GET; the daily symbol uses POST.

Install

npm install @roxyapi/sdk

pip install roxy-sdk

composer require roxyapi/sdk

dotnet add package RoxyApi.Sdk

Set the API key once at SDK construction. Detailed setup in SDK install + usage.

Call the endpoint

The #1 dream call is symbol lookup. Kebab-case IDs like water, losing-teeth, chase-dreams. Dream meanings are English-only.

curl "https://roxyapi.com/api/v2/dreams/symbols/water" \
  -H "X-API-Key: $ROXY_API_KEY"

import { createRoxy } from '@roxyapi/sdk';

const roxy = createRoxy(process.env.ROXY_API_KEY!);

const { data, error } = await roxy.dreams.getDreamSymbol({
  path: { id: 'water' },
});
if (error) throw error;

console.log(data.name);
console.log(data.meaning);

import os
from roxy_sdk import create_roxy

roxy = create_roxy(os.environ['ROXY_API_KEY'])

symbol = roxy.dreams.get_dream_symbol(id='water')
print(symbol['name'])
print(symbol['meaning'])

<?php

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));

$symbol = $roxy->dreams->getDreamSymbol(id: 'water');
echo $symbol['name'];
echo $symbol['meaning'];

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);

var symbol = await roxy.Dreams.Symbols["water"].GetAsync();

Console.WriteLine(symbol!.Name);
Console.WriteLine(symbol.Meaning);

claude mcp add-json --scope user roxy-dreams '{"type":"http","url":"https://roxyapi.com/mcp/dreams","headers":{"X-API-Key":"YOUR_KEY"}}'

Response:

{
  "id": "water",
  "name": "Water",
  "letter": "w",
  "meaning": "Water in dreams represents your emotional state and subconscious mind..."
}

Render the result

Use the dream card from @roxyapi/ui, <roxy-dream-card>, exposed in React as RoxyDreamCard. Pass the unwrapped symbol data straight in; for a browsable dictionary, <roxy-dream-search> renders the list response with an A to Z bar and opens a picked symbol in place.

'use client';
import { RoxyDreamCard } from '@roxyapi/ui-react';
import type { GetDreamsSymbolsByIdResponse } from '@roxyapi/sdk';

export function DreamSymbol({ data }: { data: GetDreamsSymbolsByIdResponse }) {
  return <RoxyDreamCard data={data} />;
}

data is the unwrapped SDK response (const { data } = await roxy.dreams.getDreamSymbol(...)), typed by GetDreamsSymbolsByIdResponse from @roxyapi/sdk. The card renders the name and meaning fields without bespoke code.

Ship the rest

Search and browse

GET /dreams/symbols returns a paginated list. Pass q=flying for keyword matches, letter=a for the A index, limit and offset for pagination.

Use GET /dreams/symbols/letters for an A-Z navigation bar with counts. The letters map omits letters with no symbols, and total gives the dictionary size. For an explore button, GET /dreams/symbols/random returns full meanings for count symbols, from 1 to 10. Random discovery is separate from the repeatable daily prompt below.

Daily dream symbol

POST /dreams/daily returns a symbol-of-the-day with an optional seed for per-user determinism.

Build a dream journal

Keep entries, user-selected symbols, notes, favorites and deletion controls in your own application. Search with q, let the reader choose a matching symbol, then fetch its detail for the full meaning. The API supplies a symbol dictionary, not journal storage, automatic dream diagnosis or personal pattern analysis. Present meanings as optional interpretations alongside the reader context.

For a daily prompt, pass the intended calendar date and a non-secret seed. A repeatable symbol is a prompt for reflection, not a prediction. Keep journal text out of share cards unless the reader chooses to include it.

See the full list at the Dreams API reference.

Ready-made template

The /templates/dreams-starter-app template ships a working Dream interpretation app you can clone, white-label, and deploy. MIT licensed. For the render layer, see the component catalog in @roxyapi/ui.

Gotchas

• Symbol IDs are kebab-case, which is the form the responses echo. losing-teeth. Casing and separators are flexible, so Losing_Teeth resolves too. Not losingTeeth.
• Dreams content is English-only. Unlike other domains, translations are not yet shipped.
• The search endpoint returns summaries. Each result has id, name, and letter. Fetch /dreams/symbols/{id} for the full meaning.
• The daily endpoint is seeded. Same (seed, date) returns the same symbol (deterministic for notifications).

What to build next

For an AI dream-interpretation chatbot, the AI chatbot tutorial shows MCP wiring across domains. For typed access, the SDK guide covers search parameters.