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.

When you upload content, the platform indexes it automatically so it becomes searchable.

​
Which Library Does Your Upload Go To?

Visual Search has two private libraries. Each upload method writes to a specific library — they are not interchangeable.
Upload methodTarget libraryContent type
Upload VideoPrivate Video LibraryVideo files or direct URLs
Upload from Social MediaPrivate Video LibraryTikTok / YouTube / Instagram posts
Upload ImagePrivate Image LibraryImage files
The Private Video Library and Private Image Library are completely separate. They have different upload endpoints, different search endpoints, and return different result formats. Uploading a video never affects your image library, and vice versa.

​
How Indexing Works

1

Upload

Send a video or image to the appropriate upload endpoint. Videos go to your Private Video Library; images go to your Private Image Library.
2

Automatic Indexing

The platform processes content through two pipelines in parallel:
  • Embedding — visual frames and audio are encoded into semantic vectors, enabling natural-language and image search
  • Caption & transcription — the platform generates descriptions and transcribes spoken audio, enabling text-level search
This runs automatically. You don’t need to configure it.
3

Searchable

Once indexing completes, the content is fully searchable. Status changes from UNPARSE to PARSE.

​
Indexing Status

StatusMeaning
UNPARSEUpload accepted — indexing in progress. Not yet searchable.
PARSEIndexing complete. Fully searchable.

​
How to wait for indexing to finish

The right polling endpoint depends on which upload method you used, because the two paths return different identifiers:
Upload methodReturnsHow to check status
Upload Video (file or URL)videoNoGet Metadata with video_no
Upload ImagevideoNo per imageGet Metadata with video_no
Upload from Social MediataskId (one task expands into N videos)Get Task Status with taskId
In every case you can register a callback URL at upload time to receive a push notification instead of polling.

​
Choose an Upload Method

Upload Video → Private Video Library

Upload from a local file or a direct download URL.

Upload from Social Media → Private Video Library

Import from TikTok, YouTube, or Instagram — by post URL, creator profile, or hashtag. Up to 50 videos per request.

Upload Image → Private Image Library

Upload one or more image files. Goes to your Private Image Library — separate from your video library.