Хранилище контента

Хранилище контента — это поисковый, размеченный ИИ индекс каждого медиа-элемента в вашем хранилище OnlyFans, плюс аналитика поверх него. Как только ваше хранилище проиндексировано, вы можете найти любой клип или сет по названию или тегу за одно нажатие, вытащить целую папку как бандл и — что гораздо ценнее — читать, какой контент реально приносит выручку, что лежит без дела, где ваш спрос обгоняет предложение и какие невиданные части отправить данной когорте следующими.

Каждый endpoint ниже находится по адресу https://app.tease.link/api/admin/vault и аутентифицируется Bearer-al_live_* ключом. Все чтения требуют scope read; триггер сканирования и авто-тег требуют write. Каждый ответ — это JSON, привязанный к владельцу, выпустившему ключ — вы всегда видите только своё собственное хранилище.

Как всё устроено

Сканировать и индексировать хранилище

Индексирование — это фоновая задача. Вы запускаете её, затем опрашиваете статус, пока он не устаканится. Сканирование идемпотентно — повторный запуск обновляет индекс, а не дублирует его.

curl -X POST "https://app.tease.link/api/admin/vault/scan" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{ "started": true, "already_running": false }

curl "https://app.tease.link/api/admin/vault/scan/status" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "folders": 84,
  "items": 5120,
  "ai_tagged": 4870,
  "last_indexed_ts": 1751280000,
  "running": false,
  "last_error": ""
}

Поиск по хранилищу

Мгновенный поиск по названию и тегу через индекс. Результаты возвращаются сгруппированными по папке, с любыми свободными (без папки) элементами, вынесенными отдельно, так что пикер контента панели может отрендерить дерево мгновенно.

curl "https://app.tease.link/api/admin/vault/search?q=lingerie&scope=all&limit=200" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Query-параметры

Ответ

{
  "query": "lingerie",
  "scope": "all",
  "folders": [
    {
      "folder_id": "f_2291",
      "name": "Red lingerie set",
      "items": [
        {
          "media_id": "m_88120",
          "media_type": "photo",
          "folder_id": "f_2291",
          "folder_name": "Red lingerie set",
          "sorted": true,
          "title": "red set — teaser",
          "has_cover": true
        }
      ]
    }
  ],
  "loose": [],
  "counts": { "folders": 1, "items": 1 }
}

Каждый элемент несёт: media_id, media_type (photo, video, gif, …), folder_id, folder_name, sorted (разложен ли он), title и has_cover (доступна ли миниатюра — см. обложки).

Открыть папку

Вытащите каждый элемент в одной папке — действие «выбрать весь пак». Ответ включает плоский массив media_ids, готовый к вставке прямо в композер сообщений.

curl "https://app.tease.link/api/admin/vault/folder/f_2291" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "folder_id": "f_2291",
  "name": "Red lingerie set",
  "media_ids": ["m_88120", "m_88121", "m_88122"],
  "items": [
    { "media_id": "m_88120", "media_type": "photo", "title": "red set — teaser", "has_cover": true }
  ]
}

Вытащить дроп

Папку также можно прочитать как дроп — её элементы сгруппированы по роли (video, photoset, bts, other) с заранее упорядоченным bundle_media_ids для отправки в одно касание «отправить весь дроп». Это естественная единица, которую продаёт чаттер.

curl "https://app.tease.link/api/admin/vault/drop/f_2291" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "folder_id": "f_2291",
  "name": "Red lingerie set",
  "cover_media_id": "m_88120",
  "roles": {
    "video":    { "count": 1, "media_ids": ["m_88130"] },
    "photoset": { "count": 8, "media_ids": ["m_88120", "m_88121"] },
    "bts":      { "count": 2, "media_ids": ["m_88140", "m_88141"] },
    "other":    { "count": 0, "media_ids": [] }
  },
  "bundle_media_ids": ["m_88130", "m_88120", "m_88121", "m_88140", "m_88141"],
  "counts": { "total": 11, "video": 1, "photoset": 8, "bts": 2, "other": 0 },
  "is_drop": true
}

Обложки

Получите изображение-миниатюру для любого id медиа. Endpoint возвращает изображение-миниатюру (image/jpeg), так что направьте <img> прямо на него — обложка есть только у элементов, где has_cover равно true.

curl "https://app.tease.link/api/admin/vault/cover/m_88120" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -o cover.jpg

Возвращает 404, когда у id медиа нет обложки. Endpoint всегда отдаёт миниатюру только для id медиа в вашем собственном хранилище.

Авто-тег бэклога

auto-tag запускает ИИ-тегирование по вашим нетегированным элементам, чтобы они стали поисковыми и начали поступать в аналитику эффективности, пробелов и рекомендаций. ИИ-тегирование выполняется на стороне сервера. Это явное действие — оно никогда не прочёсывает всё ваше хранилище само по себе — и оно ограничено по стоимости и идемпотентно: уже тегированные элементы пропускаются и никогда не оплачиваются повторно, а limit зажимается до жёсткого серверного потолка, а не отклоняется.

curl -X POST "https://app.tease.link/api/admin/vault/auto-tag" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "all_untagged": true, "limit": 100 }'

const res = await fetch('https://app.tease.link/api/admin/vault/auto-tag', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEASE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ all_untagged: true, limit: 100 }),
});
const result = await res.json();

res = requests.post(
    "https://app.tease.link/api/admin/vault/auto-tag",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    json={"all_untagged": True, "limit": 100},
)
result = res.json()

Параметры тела

Ответ

{
  "tagged": [{ "media_id": "m_88120", "tags": ["lingerie", "solo", "teaser"] }],
  "tagged_count": 1,
  "skipped": [{ "media_id": "m_88121", "reason": "already_tagged" }],
  "skipped_count": 1,
  "errors": [],
  "capped": false,
  "requested": 2
}

Что продаётся — эффективность

performance ранжирует ваше хранилище по выручке: какие отдельные медиа и какие теги реально приводят к покупкам, каждый с unlock rate (как часто фанат, получивший его, его купил). Это чтение за «что работает» в панели.

curl "https://app.tease.link/api/admin/vault/performance?limit=20" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Query-параметры

Ответ

{
  "range": { "from_ts": 1748688000, "to_ts": 1751280000 },
  "media": [
    {
      "media_id": "m_88130",
      "title": "red set — full video",
      "media_type": "video",
      "folder_name": "Red lingerie set",
      "has_cover": true,
      "tags": ["lingerie", "solo"],
      "sent": 247,
      "opened": 181,
      "purchased": 89,
      "revenue_cents": 142800,
      "unlock_rate": 0.34
    }
  ],
  "tags": [
    { "tag": "lingerie", "sent": 988, "opened": 731, "purchased": 301, "revenue_cents": 461500, "unlock_rate": 0.29 }
  ],
  "ppv_sends": 1320
}

Каждая строка медиа несёт media_id, title, media_type, folder_name, has_cover, tags и числа эффективности:

Что снять следующим — пробелы

gaps отвечает на «что мне снять?», выявляя теги, где спрос обгоняет предложение — темы, которые хорошо продаются, но где у вас мало элементов для отправки — наряду с тем, сколько вашего хранилища ещё неразложено или нетегировано.

curl "https://app.tease.link/api/admin/vault/gaps?limit=20" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Query-параметры

Ответ

{
  "range": { "from_ts": 1748688000, "to_ts": 1751280000 },
  "shoot_more": [
    {
      "tag": "shower",
      "revenue_cents": 88200,
      "purchased": 61,
      "sent": 140,
      "rank": 1
    }
  ],
  "total_items": 5120,
  "unsorted": 380,
  "untagged": 250
}

Каждая строка shoot_more сообщает revenue_cents, purchased, sent тега и его rank — его позицию в списке съёмки, где 1 — самый недопоставленный для своего спроса. Список приходит уже упорядоченным; вам не нужно выводить ранжирование.

Что остыло — спящее

dormant возвращает элементы хранилища, у которых была нулевая активность отправок в окне — контент, который просто лежит там и мог бы быть переотправлен. Это разность множеств между вашим хранилищем и тем, что реально продавалось или отправлялось недавно; ничто в чистом итоге вашего аккаунта OnlyFans не затрагивается.

curl "https://app.tease.link/api/admin/vault/dormant?window_days=30" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Query-параметры

Ответ

{
  "items": [
    {
      "media_id": "m_70011",
      "title": "beach throwback",
      "tags": ["outdoor", "bikini"],
      "cover": true,
      "last_sent": 1741000000
    }
  ],
  "count": 1,
  "window_days": 30
}

Когортные рекомендации

recommend — это самое ценное чтение хранилища: для заданной когорты фанатов оно возвращает невиданный контент — элементы, которые этой когорте не отправлялись — ранжированные по тому, насколько хорошо они подходят. Направьте его на контент (рекомендовать для людей, купивших данную часть) или опишите когорту теми же фильтрами аудитории, которые использует композер рассылок.

curl "https://app.tease.link/api/admin/vault/recommend?source=tiktok&rfm_tag=whale&limit=20" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Query-параметры

Укажите либо content_id (рекомендовать для когорты, купившей этот контент), либо один или более фильтров аудитории. Все параметры необязательны и комбинируются как AND-фильтр.

Ответ

{
  "items": [
    {
      "media_id": "m_88130",
      "title": "red set — full video",
      "tags": ["lingerie", "solo"],
      "cover": true,
      "unlock_rate": 0.4,
      "fit_reason": "Recommended for this cohort"
    }
  ],
  "cohort_summary": {
    "filters": { "source": "tiktok", "rfm_tag": "whale" },
    "source": "tiktok",
    "fan_count": 312
  },
  "thin": false
}

Каждая строка рекомендации несёт media_id, title, tags, cover, unlock_rate и короткую, человекочитаемую fit_reason, которую вы можете показать рядом с подсказкой.

Дальнейшие шаги