Structured dream-symbol data

The dream-symbol dataset, as an API

DreamMeaning.Today publishes 4,220 curated dream symbols across 12 categories. Each entry carries a structured summary, sectioned interpretation, tags, and a weighted related-symbol graph. This page is the machine-readable version: a keyed JSON API for journaling apps, sleep and wellness products, AI companions, and research tools that need dream content they can defend to a reviewer.

Why this dataset

  • 4,220 symbols across 12 categories — more than twice the largest comparable catalogue.
  • 700-3,300 words per entry, written to answer the question the title asks rather than to fill a template.
  • A taxonomy, not a word list: every symbol carries a category, tags, and related-symbol weights between 0 and 1.
  • Explicitly non-diagnostic: entries state that dreams are not diagnostic. That sentence exists so your legal and clinical reviewers have something to point at.

Endpoints

MethodPathReturns
GET/v1/symbols/{slug}Full entry: summary, sections, tags, category, related weights
GET/v1/symbolsPaginated list, filter by category or tag
GET/v1/search?q=Ranked symbol match, fuzzy on title, slug and tags
GET/v1/taxonomyThe 12 categories with symbol counts and tags
GET/v1/healthService status and your remaining quota
GET/v1/samplePublic sample: 100 entries, no key required

All responses are application/json; charset=utf-8. Authentication uses a Bearer token in the Authorization header. Quotas are per key and reported in X-RateLimit-Remaining.

Quickstart

curl https://dreammeaning.today/v1/symbols/snakes \
  -H "Authorization: Bearer $DREAMMEANING_API_KEY"
const r = await fetch("https://dreammeaning.today/v1/symbols/snakes", {
  headers: { Authorization: "Bearer " + process.env.DREAMMEANING_API_KEY },
});
const symbol = await r.json();
console.log(symbol.title, symbol.category, symbol.related.length);
import os, requests
r = requests.get("https://dreammeaning.today/v1/symbols/snakes",
                 headers={"Authorization": f"Bearer {os.environ['DREAMMEANING_API_KEY']}"},
                 timeout=10)
print(r.json()["title"], len(r.json()["sections"]))

Response shape

{
  "slug": "snakes",
  "title": "Dreaming About Snakes: Meaning, Psychology & Symbolism",
  "category": "animals",
  "tags": ["transformation", "threat", "renewal"],
  "summary": "Snake dreams most often track something in your waking life that is changing shape.",
  "sections": [{ "heading": "At a Glance", "body": "A snake may suggest change, tension, or an instinctive response." }],
  "related": [{ "slug": "being-chased", "weight": 0.71 }],
  "evidence_note": "Interpretations are reflective, not diagnostic.",
  "updated": "2026-10-23"
}

weight is the editorial co-occurrence score, 0-1. It is the part of this dataset you cannot get by scraping the public pages.

Pricing

FreeStarterGrowthEnterprise
Price$0$29/mo$99/moCustom
API calls / month50025,000150,000Negotiated
Symbol lookupyesyesyesyes
Taxonomy + weightsyesyesyesyes
Search endpoint-yesyesyes
Attributionrequiredrequiredremovedremoved
Supportcommunityemailprioritynamed contact
Bulk dataset---$2,500 one-time

Attribution on Free and Starter means a visible "Powered by DreamMeaning.Today" link next to any symbol content you display. Keys are issued manually, usually within one business day.

Licence, in plain English

  • You may use the output inside your product. You may not republish it as a standalone dictionary, dataset, or API of your own.
  • You may not use it to build or train a competing symbol database.
  • Attribution tiers must display the credit link; higher tiers may remove it.
  • Usage is capped and auditable. We do not read your users' data; we do read your call counts.
  • Interpretations are not medical advice and must not be presented as diagnosis or prediction.
  • Either side can end the agreement with 30 days' notice; we can revoke a key immediately for redistribution.

FAQ

Is this the same text as the public pages?

The prose is the same. The structure is not: taxonomy, tags, related weights and cursor pagination exist only in the API. Scraping the website gets you prose; it does not get you the graph.

How was the content produced?

Editorially, against a published standard: no fear framing, no prediction claims, explicit "not diagnostic" statements. See /editorial-standards for the process.

Can I cache responses?

Yes, up to 30 days per symbol. Cached reads do not count against quota; cache misses do.

What happens when I hit the quota?

Requests return 429 with X-RateLimit-Reset. Nothing is deleted and the key keeps working at the next window.

Is there an interpretation endpoint or an MCP server?

Not yet. Both are in development; ask for early access and you will get it before it is public.

Is there a trial?

The free tier is 500 calls a month with no card and no sales call. A 14-day Growth trial is available on request.

Start with 500 free calls. No card, no sales call.