Dream Interpretation API
List and search dream symbols
Browse and search our complete dream interpretation dictionary containing 2,000+ dream symbols with psychological meanings. Find dream meanings for animals (snake dreams, spider dreams, dog dreams), common scenarios (falling dreams, flying dreams, being chased, drowning), people (dreams about mother, father, baby, ex), objects (car, house, water, fire), emotions (fear, anxiety, love), body parts (teeth falling out, hair, eyes), colors, numbers, and abstract concepts. Filter by starting letter for A-Z navigation or search by keyword to find what your dreams mean.
Request
GET /api/v2/dreams/symbols
Parameters
| Parameter | Type | Description |
|---|---|---|
| qquery | string | Search query to match against symbol names and meanings. Case-insensitive. |
| letterquery | string | Filter symbols by starting letter (a-z). Case-insensitive. |
| limitquery | integer | Maximum items to return per page. Range: 1-50, default 20. Default 20. |
| offsetquery | integer | Number of items to skip for pagination. Default 0. Default 0. |
Response
Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.
{
"total": 2526,
"limit": 50,
"offset": 0,
"symbols": [
{
"id": "snake",
"name": "Snake",
"letter": "s"
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
| total* | number | Total number of dream symbols matching your search or filter criteria. |
| limit* | number | Page size used for this response. |
| offset* | number | Number of symbols skipped. Use with limit for pagination. |
| symbols* | array of object | Dream symbols for the current page. Use /symbols/{id} to get full interpretation. |
| symbols[].id* | string | Unique symbol identifier in kebab-case. |
| symbols[].name* | string | Display name of the dream symbol. |
| symbols[].letter* | string | Starting letter for alphabetical filtering. |
Call it in your language in seconds.
Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.dreams.searchDreamSymbols()from roxy_sdk import create_roxy
roxy = create_roxy("YOUR_API_KEY")
result = roxy.dreams.search_dream_symbols()use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->dreams->searchDreamSymbols();using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Dreams.Symbols.GetAsync();import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Dreams.SearchDreamSymbols(ctx, nil)curl "https://roxyapi.com/api/v2/dreams/symbols" \
-H "X-API-Key: YOUR_KEY"Prefer to try before you write code? Run this Dreams endpoint live in the API playground and inspect a real production response.
More Dream Interpretation endpoints
The Dream Interpretation API bundles these related endpoints under one key.
Get dream symbol details
Get the complete dream interpretation for a specific symbol. Understand what your dream means with detailed psychological analysis covering subconscious symbolism, emotional significance, and connections to your waking life. Covers all major dream themes: snake dreams (hidden fears, transformation), falling dreams (loss of control, anxiety), water dreams (emotions, cleansing), death dreams (endings, transformation), teeth falling out (self-image, communication anxiety), being chased (avoidance, confronting fears), flying dreams (freedom, ambition), and thousands more dream meanings.
Try it liveGet symbol counts by letter
Get the count of dream symbols available for each letter A-Z. Build alphabetical dream dictionary navigation to help users browse dream interpretations by letter - from abandonment dreams to zodiac dreams. See how many dream meanings exist for each starting letter.
Try it liveGet random dream symbols
Discover random dream symbols and their interpretations for daily dream insights and exploration. Each request returns different symbols from the 2,000+ dream meaning database - perfect for dream of the day features, dream journaling prompts, meditation on subconscious themes, or exploring what different dreams mean. Get one or multiple random dream interpretations with full psychological meanings.
Try it liveRemote MCP for AI agents
Every Dreams endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.
claude mcp add --transport http \
roxy-dreams https://roxyapi.com/mcp/dreams \
--header "X-API-Key: YOUR_KEY"Tool name for GET /dreams/symbols: get_dreams_symbols. Full MCP setup guide
What you can build
Build dream journal apps that interpret entries automatically. Users describe dreams and receive instant psychological insights about recurring symbols like snakes, teeth, flying, and water
Power AI dream analysis chatbots with MCP. Your OpenAI, Claude, or Gemini agent auto-discovers dream endpoints and delivers conversational dream interpretations
Create dream dictionary websites and mobile apps with alphabetical browsing, keyword search, random exploration, and 2,000+ symbols with detailed meanings
Add dream interpretation to sleep tracking apps. Correlate dream themes with sleep quality, stress levels, and daily activities for holistic wellness insights
Build comprehensive spiritual guidance platforms combining dream analysis with astrology, tarot, numerology, and I-Ching under one API key
Ship educational psychology platforms teaching dream symbolism, Jungian archetypes, and subconscious mind patterns through interactive dream exploration
Drop-in UI components
Render Dream Interpretation API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.
Related capabilities
Dream Interpretation API FAQ
What does the Dream Interpretation API return?
Browse and search our complete dream interpretation dictionary containing 2,000+ dream symbols with psychological meanings. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.
How do I authenticate with the Dream Interpretation API?
Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.
Does the Dream Interpretation API support multiple languages?
The Dream Interpretation API returns English responses. Other RoxyAPI domains such as astrology and numerology translate the full interpretation text across 8 languages via the lang query parameter.
Is the Dream Interpretation API available over Remote MCP for AI agents?
Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/dreams over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.
How is the Dream Interpretation API billed?
Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Dream Interpretation API is included at no extra cost.
Start using Dream Interpretation API today.
Ship a dream analysis app with 2,000+ symbols. This weekend.
All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.
Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key