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)
Import post URLs into the Public Video Library — searchable by all Memories.ai users. Free of charge if the video is already in the public library.
Videos contributed to the public library are permanent and visible to all users. This cannot be undone. Use Import from Post URLs — Private if you want a private copy instead.

​
Prerequisites

​
Request Example

import requests

headers = {"Authorization": "sk-mavi-..."}
payload = {
    "video_urls": [
        "https://www.tiktok.com/@cutshall73/video/7543017294226558221"
    ],
    "callback_url": "https://your.app/callback",
    "quality": "720"
}
response = requests.post(
    "https://api.memories.ai/serve/api/v1/scraper_url_public",
    json=payload,
    headers=headers
)
print(response.json())

​
Parameters

​
video_urls
array
required
List of post URLs to import. Combined with tiktok_post_urls (if provided), the total must not exceed 50 URLs. All URLs must be from the same platform.
​
tiktok_post_urls
array
Additional TikTok post URLs.
​
callback_url
string
URL to receive POST notifications on task progress and per-video indexing completion.
​
quality
string
default:"720"
Target resolution. One of "360", "480", "720", "1080", "1440", "2160".
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 to check progress.

​
Notes & Limits

  • Permanent contribution: Videos uploaded here are visible to all Memories.ai users and cannot be deleted.
  • Free for duplicates: If the video is already in the public library, the import is a no-op metadata refresh — no extra credits.
  • Rate limiting: See Rate limits.