Name: Dream Pattern Intelligence API
Brand: nicheapi-llc-1
SKU: api-nicheapi-llc-1-dreamintel
Availability: InStock
Author: API Market

True Scary Stories

# Dream Pattern Intelligence API

## Overview
The Dream Pattern Intelligence API is a multi-layer dream interpretation engine that delivers structured psychological analysis of dream narratives. Drawing on Jungian analytical psychology, Freudian psychoanalysis, and cross-cultural dream symbolism, the API decodes dreams across four analytical layers: symbols, narrative patterns, archetypes, and emotional tone. It covers 159 dream symbol keywords mapping to 76 unique symbols, 21 narrative patterns, 14 Jungian archetypes, and 25 emotional themes — making it a comprehensive resource for developers, wellness platforms, sleep technology companies, and researchers building tools around the psychology of dreaming.

## Features

*   **Multi-Layer Analysis**: Every dream is analyzed across four dimensions — symbols, narrative patterns, Jungian archetypes, and emotional tone — returning structured, machine-readable output.
*   **Rich Symbol Library**: 159 dream symbol keywords mapped to 76 unique symbols across 10 categories: water, animals, nature, body, objects, places, people, vehicles, actions, and supernatural.
*   **21 Narrative Patterns**: Detects common dream structures including being chased, falling, flying, teeth falling out, water dreams, visitations, and transformations.
*   **14 Jungian Archetypes**: Identifies activation of The Self, Shadow, Anima/Animus, Hero, Wise Old Man/Woman, Trickster, Great Mother, Child, Magician, Lover, Sage, and Explorer.
*   **Emotional Analysis**: Scores 25 emotional themes across primary and secondary categories with intensity ratings.
*   **Dream Identity Profiles**: Aggregates multiple dream analyses into a longitudinal profile, revealing dominant archetypes, recurring emotional themes, and a personal dream signature — including profile type, growth edge, and shadow warning.
*   **Batch Processing**: Interpret up to 50 dream narratives in a single request.
*   **Built-In Test Scenarios**: 8 richly detailed sample dreams with full interpretations across diverse dream types, ideal for prototyping.
*   **Reference Data Endpoints**: Direct access to the full symbol, archetype, pattern, and emotional theme dictionaries.

## Use Cases

The Dream Pattern Intelligence API is suited for a range of products and research workflows:

*   **Dream Journaling Apps**: Call the interpret endpoint on every journal entry to return multi-layer analysis — symbols detected, archetypes activated, emotional tone — and build dream dashboards that surface recurring patterns over time.
*   **Wellness & Mental Health Platforms**: Use the profile endpoint to generate shareable dream identity cards and track how a user's dream patterns evolve through life transitions such as career changes, grief, or major relationships.
*   **Sleep Technology Companies**: Differentiate sleep tracking products with psychological dream analysis delivered as part of the morning report — not just sleep quality metrics, but structured insight into what the psyche processed overnight.
*   **Therapy & Clinical Support**: Clinicians can batch-analyze client dream journals across therapy milestones, tracking archetype activation and emotional themes over time using structured output as a common clinical language.
*   **Content Creation**: Writers, game designers, and artists can use the reference data — 159 symbol keywords, 21 patterns — for creative inspiration, dream logic in story structures, archetypal characters, and symbolic imagery.
*   **Research & Education**: Researchers and students can access structured dream analysis datasets for psychological studies and empirical exploration of dream content.


## API Documentation

### Base URL
All API requests for the Dream Pattern Intelligence API should be made to the following base URL:
`https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel`

### Authentication
Authentication is handled via an API key obtained from RapidAPI. Include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key from RapidAPI.


### Endpoints

#### 1. Interpret a Dream

Perform a full multi-layer dream interpretation for a single narrative.

**Method**: `POST`
**Endpoint**: `/v1/dreamintel/interpret`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `dream_text` | body | The full dream narrative to analyze | `string` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/interpret" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dream_text": "I was walking through a vast forest at night. The trees were impossibly tall, their branches forming a canopy that blocked the moon. I heard footsteps behind me but when I turned, nothing was there. I started running but my legs felt heavy, like wading through water."}'
```

**Example Response (200 OK)**:

```json
{
  "text_preview": "I was walking through a vast forest at night...",
  "text_length": 312,
  "insight_summary": "Dream pattern: Being Chased | Emotional tone: Terror | Dominant archetype: The Shadow",
  "narrative_patterns": [
    {"pattern_id": "PAT-001", "pattern_name": "Being Chased", "match_count": 3, "confidence": 1.0},
    {"pattern_id": "PAT-015", "pattern_name": "Being Lost", "match_count": 1, "confidence": 0.35}
  ],
  "symbols_detected": [
    {"symbol_id": "SYM-030", "intensity_factor": 0.5, "confidence": 0.7},
    {"symbol_id": "SYM-034", "intensity_factor": 0.7, "confidence": 0.9}
  ],
  "symbol_count": 4,
  "archetypes_activated": [
    {"archetype_id": "ARCH-002", "archetype_name": "The Shadow", "activation_score": 5.4}
  ],
  "dominant_archetype": {
    "name": "The Shadow",
    "description": "The unconscious aspect of the personality that the conscious ego does not identify with.",
    "activation_score": 5.4
  },
  "emotional_analysis": {
    "primary": "Terror",
    "intensity": 0.9,
    "all_emotions": [
      {"name": "Terror", "intensity": 0.9},
      {"name": "Anxiety", "intensity": 0.6}
    ]
  },
  "interpretation_confidence": 0.82,
  "lucidity_assessment": {
    "estimated_lucidity": 0
  }
}
```

#### 2. Batch Interpret Dreams

Interpret up to 50 dream narratives in a single request.

**Method**: `POST`
**Endpoint**: `/v1/dreamintel/interpret/batch`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `dreams` | body | Array of dream objects, each containing a `dream_text` string (max 50) | `array` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/interpret/batch" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dreams": [
      {"dream_text": "I was flying over a canyon at sunrise..."},
      {"dream_text": "My teeth were crumbling and falling out..."}
    ]
  }'
```

#### 3. Generate Dream Identity Profile

Generate a longitudinal dream identity profile from multiple dream narratives. Returns a profile type, dominant archetypes, recurring emotional themes, growth edge, and shadow warning.

**Method**: `POST`
**Endpoint**: `/v1/dreamintel/profile`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `dreams` | body | Array of dream objects, each containing a `dream_text` string | `array` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/profile" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dreams": [
      {"dream_text": "I was walking through a vast forest at night..."},
      {"dream_text": "I was flying over a beautiful coastline..."}
    ]
  }'
```

#### 4. Run Test Scenarios

Run analysis across a specified number of built-in sample dreams, covering diverse dream types including chase, flying, visitation, and transformation dreams.

**Method**: `POST`
**Endpoint**: `/v1/dreamintel/test`

**Request Body**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `count` | body | Number of sample dream scenarios to run | `integer` | No | `1` | `8` |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/test" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 3}'
```

#### 5. List Dream Symbols

Retrieve all 159 dream symbol keywords with their symbol mappings and category classifications.

**Method**: `GET`
**Endpoint**: `/v1/dreamintel/symbols`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/symbols" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 6. List Archetypes

Retrieve all 14 Jungian archetypes with full descriptions.

**Method**: `GET`
**Endpoint**: `/v1/dreamintel/archetypes`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/archetypes" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 7. List Narrative Patterns

Retrieve all 21 narrative dream patterns with match criteria and descriptions.

**Method**: `GET`
**Endpoint**: `/v1/dreamintel/patterns`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/patterns" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 8. List Emotional Themes

Retrieve all 25 emotional themes with intensity scale definitions.

**Method**: `GET`
**Endpoint**: `/v1/dreamintel/themes`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/themes" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 9. Get Knowledge Base Statistics

Retrieve aggregate statistics across the full dream interpretation knowledge base.

**Method**: `GET`
**Endpoint**: `/v1/dreamintel/statistics`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/statistics" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 10. Health Check

Check API availability and retrieve live dataset statistics.

**Method**: `GET`
**Endpoint**: `/v1/dreamintel/health`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/dreamintel/v1/dreamintel/health" \
  -H "x-api-market-key: YOUR_API_KEY"
```


## Status Codes
Below is a list of common HTTP status codes you may encounter when interacting with the Dream Pattern Intelligence API:

*   **`200 OK`**: The request was successful and the server has returned the requested data.
*   **`400 Bad Request`**: The server could not process the request due to invalid input — such as a missing `dream_text` field, malformed JSON, or a batch array exceeding 50 items. Review your request body before retrying.
*   **`401 Unauthorized`**: Authentication failed. Your `x-api-market-key` header is missing or contains an invalid key. Confirm your key is active and correctly included in the request header.
*   **`403 Forbidden`**: Your API key is valid, but your current plan does not permit access to the requested resource or endpoint. Review your plan's permissions on RapidAPI.
*   **`404 Not Found`**: The requested endpoint does not exist. Verify the URL path against the endpoint reference above.
*   **`429 Too Many Requests`**: You have exceeded your plan's rate limit. Implement client-side rate limiting and exponential backoff. Check the `Retry-After` response header for guidance on when to retry.
*   **`500 Internal Server Error`**: An unexpected server-side error occurred. Retry the request after a short delay.
*   **`503 Service Unavailable`**: The server is temporarily unavailable due to maintenance or elevated load. Retry after a short delay.

## Rate Limits

Rate limits vary by plan:

| Plan | Price | Requests/Month | Rate Limit |
| :--- | :--- | :--- | :--- |
| **Free** | $0 | 100 | 10 req/min |
| **Pro** | $49/mo | 5,000 | 60 req/min |
| **Business** | $149/mo | 50,000 | 300 req/min |
| **Enterprise** | $499/mo | 500,000 | 1,000 req/min |

If you exceed your plan's rate limit, the API returns a `429 Too Many Requests` status code. Implement exponential backoff in your client and monitor the `Retry-After` header for retry timing guidance.

## FAQ

*   **What psychological frameworks does the API use?**
    The API combines Jungian analytical psychology, Freudian psychoanalysis, and cross-cultural dream symbolism with semantic NLP techniques to deliver the four-layer analysis.

*   **How many dreams can I submit in a batch request?**
    The batch interpret endpoint accepts up to 50 dream narratives per request.

*   **What is a Dream Identity Profile?**
    A profile is generated by passing multiple dreams to the `/profile` endpoint. It aggregates patterns across all submitted dreams to return a profile type (e.g., The Seeker, Dream Warrior, Alchemist), dominant archetypes, recurring emotional themes, a growth edge, and a shadow warning.

*   **Can I test the API before building a full integration?**
    Yes. The `/test` endpoint runs analysis across up to 8 built-in sample dreams covering diverse dream types — no dream text input required. Use this to explore the response schema and validate your parsing logic.

*   **How do I access the symbol, archetype, and pattern libraries directly?**
    The reference endpoints — `/symbols`, `/archetypes`, `/patterns`, and `/themes` — return the full dictionaries used by the interpretation engine. These are useful for building UI dropdowns, documentation, or creative reference tools.

*   **How do I authenticate my requests?**
    All requests require an `x-api-market-key` header with your API key obtained from RapidAPI.

*   **What rate limit applies to my plan?**
    Rate limits range from 10 requests/minute on the Free plan to 1,000 requests/minute on Enterprise. See the Rate Limits section for the full breakdown.

## Contact Us

For questions or support, contact the developer at [21truescarystories@gmail.com](mailto:21truescarystories@gmail.com).