Dream interpretation API with a 2,200+ symbol dream dictionary and psychological meanings covering animals, objects, emotions, people, scenarios, and abstract concepts. Decode dreams about falling, flying, teeth falling out, being chased, water, snakes, and more. Search, browse A-Z, or discover random symbols. Build dream journal apps, AI dream analysis chatbots, sleep-tracking features, and wellness platforms. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
5 endpoints. Product page. Typed SDKs in six languages carry every operation below.
GET /api/v2/dreams/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.
| Parameter | Type | Description |
|---|---|---|
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. |
curl "https://roxyapi.com/api/v2/dreams/symbols" \
-H "X-API-Key: YOUR_KEY"| Field | Type | Description |
|---|---|---|
total required | number | Total number of dream symbols matching your search or filter criteria. |
limit required | number | Page size used for this response. |
offset required | number | Number of symbols skipped. Use with limit for pagination. |
symbols required | array of object | 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. |
symbols[].id required | string | Unique symbol identifier in kebab-case. |
symbols[].name required | string | Display name of the dream symbol. |
symbols[].letter required | string | Starting letter for alphabetical filtering. |
{
"total": 2526,
"limit": 50,
"offset": 0,
"symbols": [
{
"id": "snake",
"name": "Snake",
"letter": "s"
}
]
}GET /api/v2/dreams/symbols/random
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.
| Parameter | Type | Description |
|---|---|---|
count query | integer | Number of random symbols to return (1-10). Default: 1. Default 1. |
curl "https://roxyapi.com/api/v2/dreams/symbols/random" \
-H "X-API-Key: YOUR_KEY"| Field | Type | Description |
|---|---|---|
symbols required | array of object | |
symbols[].id required | string | Unique symbol identifier in kebab-case. Use this to fetch full interpretation via /symbols/{id}. |
symbols[].name required | string | Display name of the dream symbol. |
symbols[].letter required | string | Starting letter (a-z) for alphabetical dream dictionary navigation. |
symbols[].meaning required | string | Full psychological dream interpretation explaining the subconscious symbolism, emotional significance, and waking-life connections of this dream symbol. |
{
"symbols": [
{
"id": "snake",
"name": "Snake",
"letter": "s",
"meaning": "To see a snake in your dream signifies hidden fears and worries that are threatening you. Your dream may be alerting you to something in your waking life that you are not aware of or that has not yet surfaced."
}
]
}GET /api/v2/dreams/symbols/letters
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.
curl "https://roxyapi.com/api/v2/dreams/symbols/letters" \
-H "X-API-Key: YOUR_KEY"| Field | Type | Description |
|---|---|---|
letters required | object | Map of starting letter to symbol count. Use to build A-Z dream dictionary navigation showing how many dream meanings exist per letter. |
total required | number | Total number of dream symbols in the complete dream interpretation database. |
{
"letters": {
"a": 138,
"b": 282,
"c": 324,
"d": 173
},
"total": 2526
}GET /api/v2/dreams/symbols/{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.
| Parameter | Type | Description |
|---|---|---|
id required path | string | Unique symbol identifier in kebab-case (e.g., "snake", "chase-dreams", "losing-teeth"). |
curl "https://roxyapi.com/api/v2/dreams/symbols/snake" \
-H "X-API-Key: YOUR_KEY"| Field | Type | Description |
|---|---|---|
id required | string | Unique symbol identifier in kebab-case. Use this to fetch full interpretation via /symbols/{id}. |
name required | string | Display name of the dream symbol. |
letter required | string | Starting letter (a-z) for alphabetical dream dictionary navigation. |
meaning required | string | Full psychological dream interpretation explaining the subconscious symbolism, emotional significance, and waking-life connections of this dream symbol. |
{
"id": "snake",
"name": "Snake",
"letter": "s",
"meaning": "To see a snake in your dream signifies hidden fears and worries that are threatening you. Your dream may be alerting you to something in your waking life that you are not aware of or that has not yet surfaced."
}POST /api/v2/dreams/daily
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.
| Field | Type | Description |
|---|---|---|
seed | string | Optional seed for reproducible readings. Same seed + same date = same symbol every time. Pass any unique identifier (userId, email hash, session token). Omit for anonymous daily readings. |
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. |
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"}'| Field | Type | Description |
|---|---|---|
date required | string | Date of the daily dream symbol in YYYY-MM-DD format (UTC). Determines which symbol is selected for seeded readings. |
seed required | string | Seed used for this daily reading. Same seed on the same date always produces the identical symbol. |
symbol required | object | |
symbol.id required | string | Unique symbol identifier in kebab-case. Use this to fetch full details via /symbols/{id}. |
symbol.name required | string | Display name of the dream symbol. |
symbol.letter required | string | Starting letter (a-z) for alphabetical navigation. |
symbol.meaning required | string | Full psychological dream interpretation explaining the subconscious symbolism, emotional significance, and waking-life connections. |
dailyMessage required | string | Concise daily message summarizing the dream symbol and its key themes for quick reflection. |
{
"date": "2026-01-28",
"seed": "user123-2026-01-28",
"symbol": {
"id": "flying",
"name": "Flying",
"letter": "f",
"meaning": "Flying dreams can be the most exhilarating, liberating and instantly gratifying dreams you can ever have. These dreams are classified as lucid, suggesting that the dreamer is aware that they are dreaming."
},
"dailyMessage": "Your dream symbol for 2026-01-28: Flying. Flying dreams can be the most exhilarating, liberating and instantly gratifying dreams you can ever have..."
}Hi, I am Rosie, your guide to the RoxyAPI insight tools.
Ask me to read your birth chart, pull a card, or map your numbers, and I will interpret what it means for you. Unlike most AIs, I never make the numbers up: every reading runs on real, verified calculations. Curious about the API, pricing, or docs instead? Ask me that too.