Aana API Overview

Aana provides a powerful API for indexing and searching video content.

Check out the API Reference for detailed information on all available endpoints.

API Overview

The Aana API is available at https://v1.api.aana.ai/.

The API is organized into several key sections:

  • Analyze: Analyze video content to extract meaningful information.
  • Index: Upload and index video content.
  • Search: Perform semantic searches on indexed video content.
  • Task Management: Monitor and manage tasks related to video processing.
  • Collection Management: Manage collections of videos, including creating, updating, and deleting collections.
  • Webhook Management: Set up webhooks to receive notifications about task completion and other events.

API Key

All API requests to the Aana API require an API key. You can obtain your API key from app.aana.ai after logging in. New users get €10 in credits to try out the API. You can also use the platform to try out the API without writing any code.

Once you are logged in, you can find your API key in the Developers section of the Aana Platform.

To authenticate your requests, include the API key in the request headers as x-api-key.

curl https://v1.api.aana.ai/index \
--request POST \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--data 'body={"video":{"url":"https://example.com/video_12345.mp4", "media_id": "12345"}, "collection": "main"}'