# Агрегация технологий
**API:** Data API
**Endpoint:** `POST /v1/beta/dataforseo/domain_analytics/technologies/aggregation_technologies/live`
**Tags:** DataForSEO
Не домены, а количества: сколько сайтов соответствует запросу по технологиям, с разбивкой по группе, категории и технологии. Возвращает `total_count`, `items_count`, `offset` и `items`, при этом `internal_groups_list_limit`, `internal_categories_list_limit`, `internal_technologies_list_limit` и `internal_list_limit` ограничивают разные уровни вложенности — задайте все четыре, иначе ответ быстро растёт. Для самих доменов, а не их количества, используйте `post_dataforseo_domains_tech_domains_by_technology_live`.
### Справочная информация о ценах
- Тарификация: заявленная стоимость ответа.
- Справочная оценка запроса: USD 0.012.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
## Base URL
- `https://openapi.felo.ai`
## Authentication
- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)
## Request body
Required: **no**
### application/json
Schema:
```json
{
"type": "array",
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"type": "object",
"properties": {
"group": {
"type": "string",
"description": "идентификатор целевой группы технологий
обязательное поле, если не указаны technology, category или keyword
необходимо задать хотя бы одно поле (group, category, keyword, technology)
полный список идентификаторов групп технологий можно найти на этой странице
пример:
\"marketing\""
},
"category": {
"type": "string",
"description": "идентификатор целевой категории технологий
обязательное поле, если не указаны group, keyword или technology
необходимо задать хотя бы одно поле (group, category, keyword, technology)
полный список идентификаторов категорий технологий можно найти на этой странице
пример:
\"crm\""
},
"technology": {
"type": "string",
"description": "целевая технология
обязательное поле, если не указаны group, keyword или category
необходимо задать хотя бы одно поле (group, category, keyword, technology)
полный список технологий можно найти на этой странице
пример:
\"Salesforce\""
},
"keyword": {
"type": "string",
"description": "целевое ключевое слово в мета-ключевых словах домена
обязательное поле, если не указаны group, category или technology
необходимо задать хотя бы одно поле (group, category, keyword, technology)
кодировка UTF-8
пример:
\"seo\" Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO — в этой статье справочного центра"
},
"mode": {
"type": [
"string",
"null"
],
"description": "режим поиска
необязательное поле
возможные типы режима поиска:
as_is - поиск результатов, точно соответствующих указанным идентификаторам групп, идентификаторам категорий или названиям технологий
entry - поиск результатов, соответствующих части указанных идентификаторов групп, идентификаторов категорий или названий технологий
значение по умолчанию: as_is"
},
"filters": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
]
},
"description": "массив параметров фильтрации результатов
необязательное поле
можно добавить несколько фильтров одновременно (не более 8)
между условиями нужно указать логический оператор and или or
поддерживаются следующие операторы:
<, <=, >, >=, =, <>, in, not_in, like,not_like
оператор % можно использовать с like и not_like для сопоставления любой строки из нуля или более символов
для фильтрации результатов можно использовать следующие параметры: domain_rank, last_visited, country_iso_code, language_code, content_language_code
Примечание: все параметры фильтрации берутся из domain_technology_item эндпоинта domain_technologies;
пример:
[[\"country_iso_code\",\"=\",\"US\"],
\"and\",
[\"domain_rank\",\">\",800]] Подробнее о фильтрах — в Domain Analytics Technologies API - Filters"
},
"order_by": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "правила сортировки результатов
необязательное поле
для сортировки результатов можно использовать следующие значения: groups_count, categories_count, technologies_count
возможные типы сортировки:
asc - результаты сортируются по возрастанию
desc - результаты сортируются по убыванию
для задания типа сортировки используйте запятую
пример:
[\"groups_count,desc\"]
в одном запросе можно задать не более трёх правил сортировки
несколько правил сортировки нужно разделять запятой
пример:
[\"groups_count,desc\",\"technologies_count,desc\"]
значение по умолчанию:
[\"groups_count,desc\",\"categories_count,desc\",\"technologies_count,desc\"]"
},
"internal_groups_list_limit": {
"type": [
"integer",
"null"
],
"description": "максимальное количество возвращаемых групп технологий
необязательное поле
с помощью этого поля можно ограничить количество элементов с одинаковым \"group\" в результатах
значение по умолчанию: 5
минимальное значение: 1
максимальное значение: 10000"
},
"internal_categories_list_limit": {
"type": [
"integer",
"null"
],
"description": "максимальное количество возвращаемых категорий технологий в одной группе
необязательное поле
с помощью этого поля можно ограничить количество элементов с одинаковым \"category\" в результатах
значение по умолчанию: 5
минимальное значение: 1
максимальное значение: 10000"
},
"internal_technologies_list_limit": {
"type": [
"integer",
"null"
],
"description": "максимальное количество возвращаемых технологий в одной категории
необязательное поле
с помощью этого поля можно ограничить количество элементов с одинаковым \"technology\" в результатах
значение по умолчанию: 10
минимальное значение: 1
максимальное значение: 10000"
},
"internal_list_limit": {
"type": [
"integer",
"null"
],
"description": "максимальное количество элементов с одинаковыми \"category\", \"group\" и \"technology\"
необязательное поле
если используете это поле, значения, указанные в internal_groups_list_limit, internal_categories_list_limit и internal_technologies_list_limit, игнорируются;
с помощью этого поля можно ограничить количество элементов с одинаковыми \"category\", \"group\" или \"technology\"
значение по умолчанию: 10
минимальное значение: 1
максимальное значение: 10000"
},
"limit": {
"type": [
"integer",
"null"
],
"description": "максимальное количество возвращаемых технологий
необязательное поле
значение по умолчанию: 100
максимальное значение: 10000"
},
"offset": {
"type": [
"integer",
"null"
],
"description": "смещение в массиве результатов возвращаемых доменов
необязательное поле
значение по умолчанию: 0
максимальное значение: 9999
если указать значение 10, первые десять технологий в массиве результатов будут пропущены, а данные будут предоставлены для последующих технологий"
},
"tag": {
"type": [
"string",
"null"
],
"description": "пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значение tag вы найдёте в объекте data ответа"
}
},
"example": [
{
"mode": "entry",
"technology": "Nginx",
"keyword": "WordPress",
"filters": [
[
"country_iso_code",
"=",
"US"
],
"and",
[
"domain_rank",
">",
800
]
],
"order_by": [
"groups_count,desc"
],
"limit": 10
}
]
}
]
},
"example": [
{
"mode": "entry",
"technology": "Nginx",
"keyword": "WordPress",
"filters": [
[
"country_iso_code",
"=",
"US"
],
"and",
[
"domain_rank",
">",
800
]
],
"order_by": [
"groups_count,desc"
],
"limit": 10
}
]
}
```
## Responses
### 200 — Успешная операция
Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo"
}
]
}
```
### 400 — Запрос не удалось обработать. Проверьте параметры запроса.
### 401 — Требуется действительный API-ключ Felo.
### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.
### 403 — Аккаунту не разрешено выполнять эту операцию.
### 429 — Достигнут лимит запросов или расходов.
### 502 — Сервис не смог выполнить запрос.
### 503 — API или сервис биллинга временно недоступны.
### 504 — Истекло время ожидания обработки запроса.
### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "текущая версия API"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "общий код состояния.\nПолный список кодов ответа можно найти здесь."
},
"status_message": {
"type": [
"string",
"null"
],
"description": "общее информационное сообщение.\nПолный список общих информационных сообщений можно найти здесь."
},
"time": {
"type": [
"string",
"null"
],
"description": "общее время выполнения, секунды"
},
"cost": {
"type": [
"number",
"null"
],
"description": "общая стоимость задач, USD",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "число задач в массиве tasks",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "число задач в массиве tasks, возвращённых с ошибкой",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "идентификатор задачи\nуникальный идентификатор задачи в нашей системе в формате UUID"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "код состояния задачи\nформируется DataForSEO, может находиться в диапазоне 10000-60000\nПолный список кодов ответа можно найти здесь."
},
"status_message": {
"type": [
"string",
"null"
],
"description": "информационное сообщение задачи\nПолный список общих информационных сообщений можно найти здесь."
},
"time": {
"type": [
"string",
"null"
],
"description": "время выполнения, секунды"
},
"cost": {
"type": [
"number",
"null"
],
"description": "общая стоимость задач, USD",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "число элементов в массиве result",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "путь URL"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "содержит те же параметры, что вы указали в POST-запросе"
}
}
}
```
### Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveItem
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveItem`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "тип элемента"
},
"group": {
"type": [
"string",
"null"
],
"description": "id группы технологий"
},
"category": {
"type": [
"string",
"null"
],
"description": "id категории технологии"
},
"technology": {
"type": [
"string",
"null"
],
"description": "название технологии"
},
"groups_count": {
"type": [
"integer",
"null"
],
"description": "количество групп технологий
количество доменов, соответствующих указанным параметрам и использующих технологии из указанной group",
"format": "int64"
},
"categories_count": {
"type": [
"integer",
"null"
],
"description": "количество категорий технологий
количество доменов, соответствующих указанным параметрам и использующих технологии из указанной category",
"format": "int64"
},
"technologies_count": {
"type": [
"integer",
"null"
],
"description": "количество технологий
количество доменов, соответствующих указанным параметрам и использующих указанную technology",
"format": "int64"
}
},
"description": "массив items"
}
```
### Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveTaskInfo"
}
]
},
"description": "массив задач"
}
}
}
]
}
```
### Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResultInfo
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResultInfo`
```json
{
"type": "object",
"properties": {
"total_count": {
"type": [
"integer",
"null"
],
"description": "общее количество результатов в нашей базе данных, соответствующих вашему запросу",
"format": "int64"
},
"items_count": {
"type": [
"integer",
"null"
],
"description": "количество результатов, возвращённых в массиве items",
"format": "int64"
},
"offset": {
"type": [
"integer",
"null"
],
"description": "смещение в массиве результатов возвращённых доменов"
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveItem"
}
]
}
}
}
}
```
### Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveTaskInfo
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResultInfo"
}
]
},
"description": "массив результатов"
}
}
}
]
}
```