apps/docs/memory-api/overview.mdx
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:
<CodeGroup>Authorization: Bearer YOUR_API_KEY
// npm install supermemory
const client = new supermemory({
apiKey: "YOUR_API_KEY",
});
# pip install supermemory
client = supermemory(
api_key="YOUR_API_KEY",
)
You can use supermemory through the APIs, or using our SDKs
<CodeGroup>https://api.supermemory.ai/v3
npm i supermemory
pip install supermemory
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."}'
await client.memory.add({
content: "This is the content of my first memory.",
});
client.memory.add(
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 Reference tab.
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
- Sentence-level splitting for natural boundaries
- Context preservation with overlapping chunks
- Smart handling of long content
- Semantic coherence optimization
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."}'
await client.search.execute({
q: "This is the content of my first memory.",
});
client.search.execute(
q="This is the content of my first memory.",
)
Try it out in the API Reference tab.
You can do a lot more with supermemory, and we will walk through everything you need to.
Next, explore the features available in supermemory
<CardGroup cols={2}> <Card title="Adding memories" icon="plus" href="/memory-api/creation/adding-memories"> Adding memories </Card> <Card title="Searching and filtering" icon="search" href="/memory-api/searching/searching-memories" > Searching for items </Card> <Card title="Connectors and Syncing" icon="plug" href="/memory-api/connectors/overview" > Connecting external sources </Card> <Card title="Features" icon="sparkles" href="/memory-api/features/filtering"> Explore Features </Card> </CardGroup>