Dream Interpretation API

List and search dream symbols

GET/dreams/symbolsGET/dreams/symbols/{id}GET/dreams/symbols/lettersGET/dreams/symbols/random

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

ParameterTypeDescription
qquerystringSearch query to match against symbol names and meanings. Case-insensitive.
letterquerystringFilter symbols by starting letter (a-z). Case-insensitive.
limitqueryintegerMaximum items to return per page. Range: 1-50, default 20. Default 20.
offsetqueryintegerNumber 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.

200 OK
{
  "total": 2526,
  "limit": 50,
  "offset": 0,
  "symbols": [
    {
      "id": "snake",
      "name": "Snake",
      "letter": "s"
    }
  ]
}

Response fields

FieldTypeDescription
total*numberTotal number of dream symbols matching your search or filter criteria.
limit*numberPage size used for this response.
offset*numberNumber of symbols skipped. Use with limit for pagination.
symbols*array of objectDream symbols for the current page. Use /symbols/{id} to get full interpretation.
symbols[].id*stringUnique symbol identifier in kebab-case.
symbols[].name*stringDisplay name of the dream symbol.
symbols[].letter*stringStarting 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.

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

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.dreams.searchDreamSymbols()
Install: npm install @roxyapi/sdk

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/dreams/symbols/{id}

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 live
GET/dreams/symbols/letters

Get 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 live
GET/dreams/symbols/random

Get 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 live

Remote 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 Code / Cursor
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.

<roxy-dream-card><roxy-dream-search>
See them live on Roxy UI

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