Skip to main content

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 as follows:
Authorization: Bearer YOUR_API_KEY

Installing the clients

You can use supermemory through the APIs, or using our SDKs
https://api.supermemory.ai/v3

Add your first memory

curl https://api.supermemory.ai/v3/documents \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer SUPERMEMORY_API_KEY' \
  -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 https://api.supermemory.ai/v3/search \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer SUPERMEMORY_API_KEY' \
  -d '{"q": "This is the content of my first memory."}'
Try it out in the API Playground. You can do a lot more with supermemory, and we will walk through everything you need to. Next, explore the features available in supermemory
I