Skip to main content
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. 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

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: 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.