Категоризация домена - получение результатов задачи

Метод DomainClassification.getTask позволяет получить результат задачи на категоризацию домена.

Вариант использования: Получение и использование результатов категоризации доменов
1. Доступ к результатам задачи категоризации: после создания задачи категоризации доменов получите ее результаты с помощью DomainClassification.getTask.
2. Загрузка данных категоризации: используйте запрос API для получения подробных данных о категоризированных доменах, включая сведения об отрасли.
3. Включение данных в вашу стратегию: используйте уточненные данные категоризации для улучшения вашего конкурентного анализа, нацеливания на соответствующие отрасли или корректировки списка ключевых слов на основе релевантности домена.

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры запроса
Параметр	Описание	Тип данных	Обязательный	Значение по умолчанию	Варианты значений
method	Название API метода	string	да		DomainClassification.addTask
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	да		Любое числовое или текстовое значение. Например: 1, test
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	да
task_id	Идентификатор задачи для получения результата (получить его можно из метода: DomainClassification.addTask)	int	да		Идентификатор задачи. Например: bc04446cc-322e-4706-a674-1eea6f81fb2

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
task_id	Идентификатор задачи
data	Массив с данными
domain	Анализируемый домен
categories_names	Название определенной категории домена. Unknown - в случае, если мы не смогли определить категорию домена Unreachable - домен уже был отправлен на категоризацию, и информация в настоящее время хранится в кэше
categories_confidence	Числовое значение, отражающее степень уверенности системы в том, что домен правильно отнесен к определенной категории. Чем выше значение categories_confidence, тем более уверен алгоритм в том, что домен принадлежит к этой конкретной категории. Для Unknown доменов categories_confidence всегда будет = 1
status	Статус задачи
created_at	Дата и время, когда была поставлена задача

Статусы задачи
Код	Описание
1	В обработке
2	Выполнен
3	Ошибка

По этому методу лимиты не списываются.

Example

Request data:

{
    "method": "DomainClassification.getTask",
    "id": 1,
    "params": {
        "task_id": "565892-fb87d8fa-f4c2-4b87-aa20-8ef72639625f"
    }
}

Response data:

{
    "id": "1",
    "result": {
        "task_id": "565892-fb87d8fa-f4c2-4b87-aa20-8ef72639625f",
        "data": [
            {
                "domain": "facebook.com",
                "categories_names": [
                    "\/Online Communities\/Social Networks"
                ],
                "categories_confidence": [
                    0.91368252038956
                ]
            },
            {
                "domain": "serpstat.com",
                "categories_names": [
                    "\/Internet \u0026 Telecom\/Web Services\/Search Engine Optimization \u0026 Marketing",
                    "\/Internet \u0026 Telecom\/Web Services\/Web Stats \u0026 Analytics",
                    "\/Business \u0026 Industrial\/Advertising \u0026 Marketing\/Marketing",
                    "\/Computers \u0026 Electronics\/Software\/Business \u0026 Productivity Software",
                    "\/Internet \u0026 Telecom\/Other"
                ],
                "categories_confidence": [
                    0.95500206947327,
                    0.93769299983978,
                    0.38967737555504,
                    0.18042197823524,
                    0.12408629059792
                ]
            }
        ],
        "status": "2",
        "created_at": "2024-07-31 13:36:20"
    }
}