Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

Product: Visual Search Use case: Upload videos and images, auto-index them, then search by natural language, image, or transcript phrase Host: https://api.memories.ai/serve/api/v1 Auth: Authorization: sk-mavi-... (no Bearer prefix)
Scrape the most recent N videos from any TikTok, YouTube, or Instagram creator profile into the Public Video Library — shared with all Memories.ai users.
Videos contributed to the public library are permanent and visible to all users. Use Import from Creator Profile — Private if you want a private copy instead.

​
Prerequisites

​
Request Example

import requests

headers = {"Authorization": "sk-mavi-..."}
payload = {
    "username": "https://www.tiktok.com/@cutshall73",
    "scraper_cnt": 10,
    "callback_url": "https://your.app/callback"
}
response = requests.post(
    "https://api.memories.ai/serve/api/v1/scraper_public",
    json=payload,
    headers=headers
)
print(response.json())

​
Parameters

​
username
string
required
Full URL of the creator’s profile page.
​
scraper_cnt
integer
Number of most recent posts to ingest.
​
callback_url
string
URL to receive POST notifications on task and per-video indexing progress.
unique_id is ignored on this endpoint — the public library has no namespaces.

​
Response Example

{
    "code": "0000",
    "msg": "success",
    "data": {
        "taskId": "31b0fccb-d6f9-4135-922d-1e8828499812"
    },
    "success": true,
    "failed": false
}

​
Response Fields

​
code
string
Business status code. 0000 indicates success.
​
msg
string
Human-readable status message.
​
data.taskId
string
Unique identifier for the import task. Use with Get Task Status.

​
Notes & Limits

  • Permanent contribution: Videos uploaded here are visible to all users and cannot be deleted.
  • Free for duplicates: Importing a creator’s video that already exists in the public library is a no-op metadata refresh.
  • Rate limiting: See Rate limits.