Анализатор контента одна из ключевых возможностей TextFrame, поэтому хотелось бы рассказать о том, как на практике использовать его.

Запрос к анализатору контента.

POST https://textframe.ru/tframe/api/v1/analyse

Authorization: Bearer <your_token>

Формат тела запроса

{
    "requestId": "your id",
    "title": "content title",
    "content": "content body",
    "isHTML": false
}

Параметры

Параметра	Тип	Описание
requestId	string	Идентификатор запроса
title	string	Заголовок текста, если он есть
content	string	Текст
isHTML	boolean	Флаг того, что текст в HTML формате

HTTP коды ответа:

• 200 – запрос успешно отработал.
• 400 – некорректный запрос.
• 401 – ошибка авторизации. Токен доступа не задан или его значение некорректно.
• 403 – доступ запрещен. Возвращается если срок действия токена истек или он был отозван)
• 429 – превышен лимит запросов

Формат тела ответа

{
    "success": true,
    "version": "1.1.0/202503181939",
    "requestId": "your id",
    "data": {
        "tokens"꞉ 125,
        "readingTime"꞉ {
            "hours"꞉ 0,
            "minutes"꞉ 3
        },
        "slang": false,
        "language": "ru",
        "categories": [
            {
                "name": "category1",
                "weight": 0.7613700837294343
            },
            {
                "name": "category2",
                "weight": 0.5438754800346736
            },
            {
                "name": "category3",
                "weight": 0.48296356841721455
            }
        ],
        "keywords": ["keyword1", "keyword2", "keyword3"],
        "people": ["person1", "person2"],
        "brand": [ "brand1", "brand2"],
        "countries": [ "country1", "country2"],
        "geo"꞉ [
            {
                "name"꞉ "location1",
                "coords"꞉ {
                    "lat"꞉ 55.755864,
                    "long"꞉ 37.617698
                }
            },
            {"name"꞉ "location2"},
            {"name"꞉ "location3"}
        ]
    }
}

Параметры:

Параметр	Тип	Описание
success	boolean	Флаг успешности операции
version	string	Версия ядра анализатора контента
requestId	string	Идентификатор запроса (совпадает с исходным, если он был задан)
data.tokens	int	Число токенов в тексте с учетом заголовка
data.readingTime	object	Время на прочтение (складывается из суммы часов и минут)
data.readingTime.hours	int	Часы на прочтение
data.readingTime.minutes	int	Минуты не прочтение
data.slang	boolean	Флаг наличия нецензурной лексики в контенте
data.language	string	Код языка текста (таблица ниже).
data.categories	array	Вектор категорий с весами
data.keywords	array	Массив ключевых слов, если удалось его определить
data.people	array	Список людей, наиболее часто упоминаемых в тексте
data.brand	array	Список брендов и организацией, наиболее часто встречающихся в тексте
data.country	array	Список стран, наиболее часто встречающихся в тексте
data.geo	array	Список географических мест, наиболее часто встречающихся в тексте
data.geo.[N].name	string	Название локации
data.geo.[N].coords	object	Координаты, если они известны системе (могут отсутствовать)
data.geo.[N].coords.lat	float	Широта
data.geo.[N].coords.long	float	Долгота

Таблица поддерживаемых языков

Код	Описание
??	Язык не был определен
ar	Арабский язык
de	Немецкий язык
el	Греческий язык
en	Английский язык
es	Испанский язык
fr	Французский язык
hy	Армянский язык
it	Итальянский язык
ka	Грузинский язык
ru	Русский язык
zh	Китайский язык