Dreams API Reference

Dream interpretation API with a 2,200+ symbol dream dictionary and psychological meanings covering animals, objects, emotions, people, scenarios, and abstract concepts.

Product page

Base URL: https://roxyapi.com/api/v2/dreams
Remote MCP: https://roxyapi.com/mcp/dreams
OpenAPI: https://roxyapi.com/api/v2/dreams/openapi.json
Auth: X-API-Key
Languages: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant
SDKs: TypeScript, Python, PHP, C#, Go, and Rust

GET /api/v2/dreams/symbols

List and search dream symbols

Browse and search our complete dream interpretation dictionary containing 2,200+ 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.

MCP tool: get_dreams_symbols
Renders with: Dream search · No-code widget

Request

Show all 4 optional fieldsShow fewer optional fields

q query, string: Search query to match against symbol names and meanings. Case-insensitive.
letter query, string: Filter symbols by starting letter (a-z). Case-insensitive.
limit query, integer: Maximum items to return per page. Range: 1-50, default 20. Default 20.
offset query, integer: Number of items to skip for pagination. Default 0. Default 0.

Response

total number, required

Total number of dream symbols matching your search or filter criteria.

limit number, required

Page size used for this response.

offset number, required

Number of symbols skipped. Use with limit for pagination.

symbols array of object, required

Dream symbols for the current page, in alphabetical order by name. With q, symbols whose name starts with the query come first, then names containing it, then symbols whose meaning mentions it, each group alphabetical. Use /symbols/{id} to get full interpretation.

Show all 3 fieldsShow fewer fields

id string, required: Unique symbol identifier in kebab-case.
name string, required: Display name of the dream symbol.
letter string, required: Starting letter for alphabetical filtering.

Errors

Status	Meaning
`400`	Validation error. `issues[]` lists every failed field.
`401`	Invalid or missing API key
`405`	Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
`429`	Monthly rate limit exceeded
`500`	Internal server error

GET /dreams/symbols

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

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.dreams.search_dream_symbols()

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->dreams->searchDreamSymbols();

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Dreams.Symbols.GetAsync();

Install: dotnet add package RoxyApi.Sdk

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Dreams.SearchDreamSymbols(ctx, nil)

Install: go get github.com/RoxyAPI/sdk-go

Rust

use roxyapi::{Roxy, types};

async fn call(roxy: &Roxy, params: &types::SearchDreamSymbolsParams) -> Result<(), roxyapi::Error> {
    let result = roxy.dreams().search_dream_symbols(params).await?;
    println!("{result:?}");
    Ok(())
}

Install: cargo add roxyapi

cURL

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

MCP

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

GET /api/v2/dreams/symbols/random

Random dream symbols

Discover random dream symbols and their interpretations for daily dream insights and exploration. Each request returns different symbols from the 2,200+ 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.

MCP tool: get_dreams_symbols_random

Request

Show all 1 optional fieldsShow fewer optional fields

count query, integer: Number of random symbols to return (1-10). Default: 1. Default 1.

Response

symbols array of object, required

Show all 4 fieldsShow fewer fields

id string, required: Unique symbol identifier in kebab-case. Use this to fetch full interpretation via /symbols/{id}.
name string, required: Display name of the dream symbol.
letter string, required: Starting letter (a-z) for alphabetical dream dictionary navigation.
meaning string, required: Full psychological dream interpretation explaining the subconscious symbolism, emotional significance, and waking-life connections of this dream symbol.

Errors

Status	Meaning
`400`	Validation error. `issues[]` lists every failed field.
`401`	Invalid or missing API key
`405`	Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
`429`	Monthly rate limit exceeded
`500`	Internal server error

GET /dreams/symbols/random

TypeScript

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.dreams.getRandomSymbols()

Install: npm install @roxyapi/sdk

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.dreams.get_random_symbols()

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->dreams->getRandomSymbols();

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Dreams.Symbols.Random.GetAsync();

Install: dotnet add package RoxyApi.Sdk

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Dreams.GetRandomSymbols(ctx, nil)

Install: go get github.com/RoxyAPI/sdk-go

Rust

use roxyapi::{Roxy, types};

async fn call(roxy: &Roxy, params: &types::GetRandomSymbolsParams) -> Result<(), roxyapi::Error> {
    let result = roxy.dreams().get_random_symbols(params).await?;
    println!("{result:?}");
    Ok(())
}

Install: cargo add roxyapi

cURL

curl "https://roxyapi.com/api/v2/dreams/symbols/random" \
  -H "X-API-Key: YOUR_KEY"

MCP

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

GET /api/v2/dreams/symbols/letters

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.

MCP tool: get_dreams_symbols_letters

Response

letters object, required: Map of starting letter to symbol count. Use to build A-Z dream dictionary navigation showing how many dream meanings exist per letter.
total number, required: Total number of dream symbols in the complete dream interpretation database.

Errors

Status	Meaning
`400`	Validation error. `issues[]` lists every failed field.
`401`	Invalid or missing API key
`405`	Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
`429`	Monthly rate limit exceeded
`500`	Internal server error

GET /dreams/symbols/letters

TypeScript

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.dreams.getSymbolLetterCounts()

Install: npm install @roxyapi/sdk

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.dreams.get_symbol_letter_counts()

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->dreams->getSymbolLetterCounts();

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Dreams.Symbols.Letters.GetAsync();

Install: dotnet add package RoxyApi.Sdk

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Dreams.GetSymbolLetterCounts(ctx, nil)

Install: go get github.com/RoxyAPI/sdk-go

Rust

use roxyapi::Roxy;

async fn call(roxy: &Roxy) -> Result<(), roxyapi::Error> {
    let result = roxy.dreams().get_symbol_letter_counts().await?;
    println!("{result:?}");
    Ok(())
}

Install: cargo add roxyapi

cURL

curl "https://roxyapi.com/api/v2/dreams/symbols/letters" \
  -H "X-API-Key: YOUR_KEY"

MCP

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

GET /api/v2/dreams/symbols/{id}

Get dream symbol by id

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.

MCP tool: get_dreams_symbols_id
Renders with: Dream card · No-code widget

Request

id path, string, required: Unique symbol identifier in kebab-case (e.g., "snake", "chase-dreams", "losing-teeth").

Response

id string, required: Unique symbol identifier in kebab-case. Use this to fetch full interpretation via /symbols/{id}.
name string, required: Display name of the dream symbol.
letter string, required: Starting letter (a-z) for alphabetical dream dictionary navigation.
meaning string, required: Full psychological dream interpretation explaining the subconscious symbolism, emotional significance, and waking-life connections of this dream symbol.

Errors

Status	Meaning
`400`	Validation error. `issues[]` lists every failed field.
`401`	Invalid or missing API key
`404`	Symbol not found.
`405`	Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
`429`	Monthly rate limit exceeded
`500`	Internal server error

GET /dreams/symbols/{id}

TypeScript

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.dreams.getDreamSymbol({ path: { id: 'snake' } })

Install: npm install @roxyapi/sdk

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.dreams.get_dream_symbol(id='snake')

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->dreams->getDreamSymbol(id: 'snake');

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Dreams.Symbols["snake"].GetAsync();

Install: dotnet add package RoxyApi.Sdk

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Dreams.GetDreamSymbol(ctx, "snake", nil)

Install: go get github.com/RoxyAPI/sdk-go

Rust

use roxyapi::{Roxy, types};

async fn call(roxy: &Roxy, params: &types::GetDreamSymbolParams) -> Result<(), roxyapi::Error> {
    let result = roxy.dreams().get_dream_symbol(params).await?;
    println!("{result:?}");
    Ok(())
}

Install: cargo add roxyapi

cURL

curl "https://roxyapi.com/api/v2/dreams/symbols/snake" \
  -H "X-API-Key: YOUR_KEY"

MCP

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

POST /api/v2/dreams/daily

Daily dream symbol

Receive a single dream symbol for daily reflection and subconscious exploration. Uses seeded randomness so the same seed gets the same symbol on the same day, perfect for "Dream Symbol of the Day" features. Provide a seed (userId, email hash, session token) for reproducible consistency, or omit for date-based daily symbols. Returns the symbol with full psychological interpretation. Great for dream journal apps, wellness platforms, morning ritual apps, and meditation tools.

MCP tool: post_dreams_daily

Request

Show all 2 optional fieldsShow fewer optional fields

seed string: Optional seed for reproducible readings. Same seed + same date = same symbol every time. Pass any unique identifier (userId, email hash, session token) to give each user their own symbol for the day. Without a seed every caller receives the same shared symbol of the day.
date string (date): Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for viewing past daily readings or pre-generating future ones.

Response

date string, required

Date of the daily dream symbol in YYYY-MM-DD format (UTC). Determines which symbol is selected for seeded readings.

seed string, required

Seed used for this daily reading. Same seed on the same date always produces the identical symbol.

symbol object, required

Show all 4 fieldsShow fewer fields

id string, required: Unique symbol identifier in kebab-case. Use this to fetch full details via /symbols/{id}.
name string, required: Display name of the dream symbol.
letter string, required: Starting letter (a-z) for alphabetical navigation.
meaning string, required: Full psychological dream interpretation explaining the subconscious symbolism, emotional significance, and waking-life connections.

dailyMessage string, required

Concise daily message summarizing the dream symbol and its key themes for quick reflection.

Errors

Status	Meaning
`400`	Validation error. `issues[]` lists every failed field.
`401`	Invalid or missing API key
`405`	Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
`429`	Monthly rate limit exceeded
`500`	Internal server error

POST /dreams/daily

TypeScript

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.dreams.getDailyDreamSymbol({ body: { seed: 'user123', date: '2026-03-06' } })

Install: npm install @roxyapi/sdk

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.dreams.get_daily_dream_symbol(seed='user123', date='2026-03-06')

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->dreams->getDailyDreamSymbol(seed: 'user123', date: '2026-03-06');

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Dreams.Daily.PostAsync(new() { /* request fields above */ });

Install: dotnet add package RoxyApi.Sdk

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Dreams.GetDailyDreamSymbol(ctx, nil, roxyapi.GetDailyDreamSymbolJSONRequestBody{ /* request fields above */ })

Install: go get github.com/RoxyAPI/sdk-go

Rust

use roxyapi::{Roxy, types};

async fn call(roxy: &Roxy, body: &types::GetDailyDreamSymbolRequest) -> Result<(), roxyapi::Error> {
    let result = roxy.dreams().get_daily_dream_symbol(body).await?;
    println!("{result:?}");
    Ok(())
}

Install: cargo add roxyapi

cURL

curl -X POST "https://roxyapi.com/api/v2/dreams/daily" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed":"user123","date":"2026-03-06"}'

MCP

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