ReelMind API

Read the memory your videos build.

Read a user's stored learning themes and recent summary snippets. Each user has their own api_key (issued manually — contact the operator). Set APIS_ENABLED=true on the deployment before using.

GET /api/memory

Quick start

Three things to send

Base URL https://reelmind.io

Auth header Authorization: Bearer <api_key>

Optional filter ?theme=cold%20email

optional — exact-match filter; omit it for all themes, or include it to narrow both themes and snippets to a single theme. Use URL encoding for the value, e.g. ?theme=cold%20email. An unknown theme returns a successful response with empty themes and snippets arrays, not a theme-specific 404.

Response

A predictable shape for every request

Every successful response contains these four top-level fields.

Field	Type	Description
`themes`	array	Learning themes with their weights and linked evidence summaries.
`snippets`	array	Recent summary snippets, each containing the summary big idea.
`user`	object	The authenticated key owner: id (number) and email (string).
`summarization_count`	number	The count of summarizations represented in the user memory response.

`themes[]` item

Field	Type	Description
`theme`	string	The exact stored learning theme label.
`weight`	number	The theme weight used to rank recurring interests.
`summary_ids`	number[]	IDs of summaries that provide evidence for the theme.
`evidence_titles`	string[]	Titles of summaries that provide evidence for the theme.

`snippets[]` item

Field	Type	Description
`summary_id`	number	The source summary ID.
`title`	string	The source video or summary title.
`video_url`	string	The source video URL.
`platform`	string	Source platform: youtube, instagram, twitter, or upload.
`created_at`	ISO 8601 timestamp	When the source summary was created.
`big_idea`	string	The summary big idea, truncated to 320 characters.

Errors

What the status codes mean

Status	Meaning
401	Missing or invalid API key
404	The requested API path does not exist. Use GET /api/memory; an unknown theme returns 200 with empty arrays instead of a theme-specific 404.
429	The upstream or edge rate limit was reached. Retry after the rate limit resets.
500	Database lookup failed
503	APIS_ENABLED is not set on the deployment

Copy and run

One request, one response

This example filters to the exact cold email theme, so both arrays show only that theme’s data.

Request

curl -H "Authorization: Bearer <api_key>" "https://reelmind.io/api/memory?theme=cold%20email"

200 JSON response

{
  "themes": [
    {
      "theme": "cold email",
      "weight": 4,
      "summary_ids": [
        102,
        87,
        65,
        41
      ],
      "evidence_titles": [
        "7 cold email rules that still work",
        "Why most cold emails fail",
        "Subject lines that get replies"
      ]
    }
  ],
  "snippets": [
    {
      "summary_id": 102,
      "title": "7 cold email rules that still work",
      "video_url": "https://www.youtube.com/watch?v=abc123",
      "platform": "youtube",
      "created_at": "2026-08-15T14:32:18.000Z",
      "big_idea": "Personalization beats volume every time — one research-backed hook per prospect outperforms three generic follow-ups."
    }
  ],
  "user": {
    "id": 42,
    "email": "example@reelmind.io"
  },
  "summarization_count": 27
}