search library

Find or list items in the library. With query: hybrid search over descriptions, tags, transcripts and what pictures show, and an indexed video or recording carries its best matching moments; without one, everything the filters match, newest first. duplicates_of finds near-identical files to one item instead. Each row carries the item’s id and ref, title, type, url, when it was added, technical data (size, dimensions, duration), and whether it is stored in the cloud or only on a machine. Pages by next_cursor. Returns the workspace’s own items; pulled posts need source pulled or their folder. A page carries feed_url for the same set on the workspace feed. This finds whole items by what they are; search_footage finds moments inside videos by what is said or shown. Free.

POST

tools

search_library

search library

curl --request POST \
  --url https://eversince.ai/api/v1/tools/search_library \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "duplicates_of": "<string>",
  "folder": "<string>",
  "subfolders": true,
  "added_from": "<string>",
  "added_to": "<string>",
  "modified_from": "<string>",
  "modified_to": "<string>",
  "favorite": true,
  "label": "<string>",
  "timeline": "<string>",
  "upload_link": "<string>",
  "fields": {},
  "hidden": true,
  "limit": 50,
  "cursor": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/search_library"

payload = {
    "query": "<string>",
    "duplicates_of": "<string>",
    "folder": "<string>",
    "subfolders": True,
    "added_from": "<string>",
    "added_to": "<string>",
    "modified_from": "<string>",
    "modified_to": "<string>",
    "favorite": True,
    "label": "<string>",
    "timeline": "<string>",
    "upload_link": "<string>",
    "fields": {},
    "hidden": True,
    "limit": 50,
    "cursor": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    duplicates_of: '<string>',
    folder: '<string>',
    subfolders: true,
    added_from: '<string>',
    added_to: '<string>',
    modified_from: '<string>',
    modified_to: '<string>',
    favorite: true,
    label: '<string>',
    timeline: '<string>',
    upload_link: '<string>',
    fields: {},
    hidden: true,
    limit: 50,
    cursor: '<string>'
  })
};

fetch('https://eversince.ai/api/v1/tools/search_library', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json

query

string

duplicates_of

string

Instead of a search: near-identical files to this item (a crop, a re-export, a version saved twice), closest first, each saying how it matched. limit applies; the other filters do not.

type

enum<string>

A recording is a video (camera or screen) or an audio item.

Available options:

image,

video,

audio,

document

folder

string

Folder path ("campaigns/july") or id.

subfolders

boolean

With folder: everything under it too, all the way down.

added_from

string

Added on or after: an ISO date or date-time, UTC (manage_settings carries the user's time zone; rows return added times in UTC). A bare date is its whole UTC day.

added_to

string

Added on or before, the same way.

modified_from

string

Last changed on or after.

modified_to

string

Last changed on or before.

sort

enum<string>

newest or oldest added, last modified, name A-Z, largest, or starred (starred only, latest first). Default newest, or relevance with query.

Available options:

newest,

oldest,

modified,

name,

size,

starred

favorite

boolean

true for starred items only, false for the rest.

stored

enum<string>

cloud: stored in the workspace's cloud storage, readable by every tool. local: only on a user's computer until synced.

Available options:

cloud,

local

source

enum<string>

Narrow to how the item came about: assets (what was uploaded or imported), generations (what a model made here), or pulled (posts kept off a platform with keep_posts).

Available options:

assets,

generations,

pulled

label

string

Only items carrying this label (by name).

timeline

string

Only this timeline's media and docs (timeline_media): what its cut uses plus what was attached to it.

upload_link

string

Only what came in through this upload link: the link_id import_media link returned.

Pattern: ^[a-z0-9]{12}$

fields

object

Custom field filters, name → required value.

Show child attributes

hidden

boolean

true for what the user hid from their feed (still in the library), false for what still shows there. Results carry hidden: true.

limit

integer

Per page. Default 30.

Required range: 1 <= x <= 100

cursor

string

next_cursor from the page before, with the same query and filters.

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

search library

curl --request POST \
  --url https://eversince.ai/api/v1/tools/search_library \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "duplicates_of": "<string>",
  "folder": "<string>",
  "subfolders": true,
  "added_from": "<string>",
  "added_to": "<string>",
  "modified_from": "<string>",
  "modified_to": "<string>",
  "favorite": true,
  "label": "<string>",
  "timeline": "<string>",
  "upload_link": "<string>",
  "fields": {},
  "hidden": true,
  "limit": 50,
  "cursor": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/search_library"

payload = {
    "query": "<string>",
    "duplicates_of": "<string>",
    "folder": "<string>",
    "subfolders": True,
    "added_from": "<string>",
    "added_to": "<string>",
    "modified_from": "<string>",
    "modified_to": "<string>",
    "favorite": True,
    "label": "<string>",
    "timeline": "<string>",
    "upload_link": "<string>",
    "fields": {},
    "hidden": True,
    "limit": 50,
    "cursor": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    duplicates_of: '<string>',
    folder: '<string>',
    subfolders: true,
    added_from: '<string>',
    added_to: '<string>',
    modified_from: '<string>',
    modified_to: '<string>',
    favorite: true,
    label: '<string>',
    timeline: '<string>',
    upload_link: '<string>',
    fields: {},
    hidden: true,
    limit: 50,
    cursor: '<string>'
  })
};

fetch('https://eversince.ai/api/v1/tools/search_library', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Discovery

Timeline

Workspace

Library

Canvas

Generation

Research

Account

Models

Uploads

Webhooks

search library

Authorizations

Headers

Body

Response