​
Authentication

Head to Supermemory’s Developer Platform built to help you monitor and manage every aspect of the API.

All API requests require authentication using an API key. Include your API key in the x-api-key header as with your token:

x-api-key: YOUR_API_KEY

​
Base URL

All API requests should be made to:

https://v2.api.supermemory.ai

​
Add your first memory

curl -X POST https://v2.api.supermemory.ai/add \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "This is the content of my first memory."}'

This will add a new memory to your Supermemory account.

Try it out in the API Playground.

​
Content Processing

When you add content to Supermemory, it goes through several processing steps:

  1. Queued: Initial state when content is submitted
  2. Extracting: Content is being extracted from the source
  3. Chunking: Content is being split into semantic chunks
  4. Embedding: Generating vector embeddings for search
  5. Indexing: Adding content to the search index
  6. Done: Processing complete

The system uses advanced NLP techniques for optimal chunking:

  • Sentence-level splitting for natural boundaries
  • Context preservation with overlapping chunks
  • Smart handling of long content
  • Semantic coherence optimization

​
Search your memories

curl -X GET https://v2.api.supermemory.ai/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "This is the content of my first memory."}'

Try it out in the API Playground.