API Документация

GET /api/search

Полнотекстовый поиск по сегментам транскрипций, экстрактам и библиотечным статьям.

Параметры

Параметр	Тип	Описание
q	string	обязательный Поисковый запрос (мин. 2 символа)
type	string	по умолчанию: segments Тип поиска: `segments` \| `workbooks` \| `library` \| `all`
page	integer	по умолчанию: 1 Номер страницы
per_page	integer	по умолчанию: 20, макс: 100 Результатов на страницу

Пример запроса

# Поиск по сегментам транскрипций curl "https://ekstraktznaniy.ru/api/search?q=маркетинг&type=segments" # Поиск по всем типам контента curl "https://ekstraktznaniy.ru/api/search?q=продажи&type=all&per_page=10"

Ответ

                        
{
  "query": "маркетинг",
  "type": "segments",
  "page": 1,
  "per_page": 20,
  "results": [
    {
      "type": "segment",
      "segment_id": 1234,
      "video_id": 89,
      "video_youtube_id": "dQw4w9WgXcQ",
      "video_title": "Как строить бренд",
      "channel_name": "Бизнес Канал",
      "segment_title": "Контент-маркетинг",
      "text_snippet": "...текст с <mark>маркетингом</mark>...",
      "start_time": 342,
      "rank": 0.0759
    }
  ]
}

GET /api/search?q=маркетинг&type=segments&per_page=3

GET /api/v1/catalog

Полный каталог контента: все экстракты, дистилляты и каналы. Оптимизирован для LLM-агентов.

Параметры

Параметр	Тип	Описание
tag	string	необязательный Фильтр по тегу экстракта
speaker	string	необязательный Фильтр по имени спикера (частичное совпадение)

Пример запроса

# Полный каталог curl "https://ekstraktznaniy.ru/api/v1/catalog" # Фильтр по тегу curl "https://ekstraktznaniy.ru/api/v1/catalog?tag=AI"

Ответ

                        
{
  "site": "Экстракт Знаний",
  "stats": { "channels": 52, "videos": 7582, "workbooks": 70, "library_articles": 6 },
  "workbooks": [
    {
      "id": 1,
      "title": "Как строить системный бизнес",
      "speaker": "Иван Иванов",
      "topic": "Бизнес-системы",
      "tags": ["бизнес", "системы"],
      "url": "https://ekstraktznaniy.ru/workbook/1",
      "markdown_url": "https://ekstraktznaniy.ru/workbook/1.md",
      "json_url": "https://ekstraktznaniy.ru/api/v1/workbook/1"
    }
  ],
  "library": [...],
  "channels": [...]
}

GET /api/v1/catalog

GET /api/v1/workbook/{id}

Полный контент экстракта (методички): тезисы, задания, цитаты, транскрипт.

Параметры пути

Параметр	Тип	Описание
id	integer	обязательный ID экстракта

Пример запроса

curl "https://ekstraktznaniy.ru/api/v1/workbook/1" # Или в Markdown формате: curl "https://ekstraktznaniy.ru/workbook/1.md"

Ответ

                        
{
  "id": 1,
  "title": "Как строить системный бизнес",
  "speaker": "Иван Иванов",
  "topic": "Бизнес-системы",
  "duration_label": "47 мин",
  "channel": { "name": "Бизнес Канал" },
  "theses": [{ "title": "...", "description": "..." }],
  "exercises": [{ "title": "...", "goal": "..." }],
  "quotes": [{ "text": "...", "author": "..." }],
  "full_markdown": "# Методичка\n\n...",
  "urls": {
    "html": "https://ekstraktznaniy.ru/workbook/1",
    "markdown": "https://ekstraktznaniy.ru/workbook/1.md",
    "json": "https://ekstraktznaniy.ru/api/v1/workbook/1"
  }
}

GET /api/v1/workbook/1

GET /api/v1/video/{id}

Полный контент видео: метаданные, все сегменты транскрипции с временными метками.

Параметры пути

Параметр	Тип	Описание
id	integer	обязательный ID видео в базе

Пример запроса

curl "https://ekstraktznaniy.ru/api/v1/video/1" # Или в Markdown формате: curl "https://ekstraktznaniy.ru/video/1.md"

Ответ

                        
{
  "id": 1,
  "youtube_id": "dQw4w9WgXcQ",
  "title": "Название видео",
  "channel": { "name": "Бизнес Канал" },
  "duration_seconds": 2847,
  "view_count": 125000,
  "segments": [
    {
      "index": 0,
      "title": "Введение",
      "start_time": 0,
      "end_time": 180,
      "text": "Сегодня мы разберём...",
      "youtube_link": "https://youtube.com/watch?v=...&t=0"
    }
  ],
  "workbook": { "id": 5, "url": "https://ekstraktznaniy.ru/workbook/5" }
}

GET /api/v1/video/1

GET /api/v1/library

Список всех дистиллятов (статей библиотеки) с метаданными.

Пример запроса

curl "https://ekstraktznaniy.ru/api/v1/library"

Ответ

                        
{
  "articles": [
    {
      "slug": "workflow",
      "title": "Рабочий процесс с Claude Code",
      "description": "...",
      "reading_time": 12,
      "tags": ["workflow", "AI"],
      "url": "https://ekstraktznaniy.ru/library/workflow",
      "markdown_url": "https://ekstraktznaniy.ru/library/workflow.md",
      "json_url": "https://ekstraktznaniy.ru/api/v1/library/workflow"
    }
  ]
}

GET /api/v1/library

GET /api/v1/library/{slug}

Метаданные конкретного дистиллята по slug.

Параметры пути

Параметр	Тип	Описание
slug	string	обязательный Slug статьи: `workflow`, `prompting`, `claudemd`, `subagents`, `insights`, `openclaw`

Пример запроса

curl "https://ekstraktznaniy.ru/api/v1/library/workflow" # Markdown версия: curl "https://ekstraktznaniy.ru/library/workflow.md"

GET /api/v1/library/workflow

GET /api/v1/tags

Все теги экстрактов с количеством методичек в каждом теге.

Пример запроса

curl "https://ekstraktznaniy.ru/api/v1/tags"

Ответ

                        
{
  "tags": [
    { "tag": "бизнес", "count": 24 },
    { "tag": "AI", "count": 18 },
    { "tag": "продажи", "count": 12 }
  ]
}

GET /api/v1/tags

GET /api/stats

Текущая статистика базы знаний: каналы, видео, сегменты, слова.

Пример запроса

curl "https://ekstraktznaniy.ru/api/stats"

Ответ

                        
{
  "channels": 52,
  "videos": 7582,
  "segments": 64477,
  "total_words": 8934521
}

GET /api/stats

GET /.well-known/ai-plugin.json

Манифест AI-плагина (стандарт OpenAI). Используется LLM-агентами для discovery.

Пример запроса

curl "https://ekstraktznaniy.ru/.well-known/ai-plugin.json"

GET /.well-known/ai-plugin.json

GET /llms.txt

Навигатор сайта в формате Markdown для LLM-агентов (стандарт llmstxt.org). Содержит список всех экстрактов и дистиллятов.

Пример запроса

curl "https://ekstraktznaniy.ru/llms.txt" # Полная версия со всем контентом (~250KB): curl "https://ekstraktznaniy.ru/llms-full.txt"

Открыть llms.txt Открыть llms-full.txt

Форматы данных

Контент доступен в HTML, JSON и Markdown форматах.

Тип контента	HTML	JSON	Markdown
Экстракт (методичка)	`/workbook/{id}`	`/api/v1/workbook/{id}`	`/workbook/{id}.md`
Видео + транскрипт	`/video/{id}`	`/api/v1/video/{id}`	`/video/{id}.md`
Дистиллят (библиотека)	`/library/{slug}`	`/api/v1/library/{slug}`	`/library/{slug}.md`
Весь каталог	—	`/api/v1/catalog`	`/llms.txt`

Пример использования в Python

import requests # Поиск знаний r = requests.get("https://ekstraktznaniy.ru/api/search", params={"q": "маркетинг", "type": "all"}) data = r.json() # Получить экстракт в Markdown md = requests.get("https://ekstraktznaniy.ru/workbook/1.md").text # Полный каталог для AI-агента catalog = requests.get("https://ekstraktznaniy.ru/api/v1/catalog").json()

API Документация

Параметры

Пример запроса

Ответ

Параметры

Пример запроса

Ответ

Параметры пути

Пример запроса

Ответ

Параметры пути

Пример запроса

Ответ

Пример запроса

Ответ

Параметры пути

Пример запроса

Пример запроса

Ответ

Пример запроса

Ответ

Пример запроса

Пример запроса

Форматы данных

Пример использования в Python

Экстракт Знаний в Telegram

Дайджест Экстрактов