To use the Supermemory API, you’ll need:

  1. An API key (get one by signing up at supermemory.ai)
  2. Basic understanding of REST APIs
  3. A tool to make HTTP requests (like curl, Postman, or your favorite programming language)

​
Base URL

All API requests should be made to:

https://api.supermemory.ai/v1

​
Add your first memory

curl -X POST https://api.supermemory.ai/v1/add \
  -H "Authorization: Bearer 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

​
Search your memories

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

Try it out in the API Playground

​
Get your memories

curl -X GET https://api.supermemory.ai/v1/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

This will return a list of all your memories.

Try it out in the API Playground

That’s it! You’ve now added your first memory and searched for it.

Was this page helpful?

IntroductionSelf-hosting