Skip to main content
The Animus REST API lets you programmatically manage your content library. Save content, search across everything you’ve collected, and organize items into collections — all with simple HTTP requests.

Base URL

Authentication

All API requests require an API key sent as a Bearer token:
API keys are created in the Animus app under Integrations > API Keys. See the authentication guide for details.

Available endpoints

Content

Save, retrieve, and manage content items in your library.

Collections

Create and manage collections to organize your content.

Search

Full-text and semantic search across your saved content.

Authentication

Create and manage API keys, scopes, and permissions.

Quick start

Save a URL to your library:
Search your library:
Get library statistics:

Response format

All API responses are wrapped in a standard envelope:
All response examples in this documentation show the contents of the data field.

Rate limits

API key requests are rate-limited per endpoint. If you exceed the limit, you’ll receive a 429 Too Many Requests response. Wait and retry after the period resets.

Errors

The API uses standard HTTP status codes: