DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Агрегація технологій
Не домени, а кількості: скільки сайтів відповідає запиту за технологіями, з розбивкою за групою, категорією та технологією. Повертає 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.
- Тип: array (object | null)[]
- categoryТип: string
- filtersТип: array (object | null)[] | null
масив параметрів фільтрації результатів
необов'язкове поле
можна додати кілька фільтрів одночасно (не більше 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"],Докладніше про фільтри — у Domain Analytics Technologies API - Filters
"and",
["domain_rank",">",800]]Порожній об'єкт - groupТип: string
- internalТип: integer | null
_categories _list _limit максимальна кількість повернутих категорій технологій у межах однієї групи
необов'язкове поле
за допомогою цього поля можна обмежити кількість елементів з однаковим"category"у результатах
значення за замовчуванням:5
мінімальне значення:1
максимальне значення:10000 - internalТип: integer | null
_groups _list _limit максимальна кількість повернутих груп технологій
необов'язкове поле
за допомогою цього поля можна обмежити кількість елементів з однаковим"group"у результатах
значення за замовчуванням:5
мінімальне значення:1
максимальне значення:10000 - internalТип: integer | null
_list _limit максимальна кількість елементів з однаковими
"category","group"і"technology"
необов'язкове поле
якщо використовуєте це поле, значення, указані вinternal_groups_list_limit,internal_categories_list_limitіinternal_technologies_list_limit, ігноруються;
за допомогою цього поля можна обмежити кількість елементів з однаковими"category","group"або"technology"
значення за замовчуванням:10
мінімальне значення:1
максимальне значення:10000 - internalТип: integer | null
_technologies _list _limit максимальна кількість повернутих технологій у межах однієї категорії
необов'язкове поле
за допомогою цього поля можна обмежити кількість елементів з однаковим"technology"у результатах
значення за замовчуванням:10
мінімальне значення:1
максимальне значення:10000 - keywordТип: string
цільове ключове слово в мета-ключових словах домену
обов'язкове поле, якщо не вказаноgroup,categoryабоtechnology
потрібно задати принаймні одне поле (group,category,keyword,technology)
кодування UTF-8
приклад:"seo"Докладніше про правила й обмеження полівkeywordіkeywordsв API DataForSEO — у цій статті довідкового центру - limitТип: integer | null
максимальна кількість повернутих технологій
необов'язкове поле
значення за замовчуванням:100
максимальне значення:10000 - modeТип: string | null
режим пошуку
необов'язкове поле
можливі типи режиму пошуку:as_is- пошук результатів, що точно відповідають указаним ідентифікаторам груп, ідентифікаторам категорій або назвам технологійentry- пошук результатів, що відповідають частині указаних ідентифікаторів груп, ідентифікаторів категорій або назв технологій
значення за замовчуванням:as_is - offsetТип: integer | null
зміщення в масиві результатів повернутих доменів
необов'язкове поле
значення за замовчуванням:0
максимальне значення:9999
якщо вказати значення10, перші десять технологій у масиві результатів буде пропущено, а дані буде надано для наступних технологій - orderТип: array string[] | null
_by правила сортування результатів
необов'язкове поле
для сортування результатів можна використовувати такі значення: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"] - tagТип: string | null
визначений користувачем ідентифікатор завдання
необов'язкове поле
обмеження — 255 символів
цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
вказане значенняtagви знайдете в об'єктіdataвідповіді - technologyТип: string
- Тип: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo200
- Тип: number | null Формат: doublecost
загальна вартість завдань, USD
- Тип: integer | nullstatus
_code загальний код стану. Повний список кодів відповіді можна знайти тут.
- Тип: string | nullstatus
_message загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.
- Тип: array (object | null)[] | nulltasks
масив завдань
- Тип: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveTaskInfo
- costТип: number | null Формат: double
загальна вартість завдань, USD
- dataТип: object | null
містить ті самі параметри, які ви вказали в POST-запиті
- propertyТип: object | null
Name
- idТип: string | null
ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID
- pathТип: array (string | null)[] | null
шлях URL
- resultТип: array (object | null)[] | null
масив результатів
- itemsТип: array (object | null)[] | null
масив items
- categoriesТип: integer | null Формат: int64
_count кількість категорій технологій
кількість доменів, що відповідають вказаним параметрам і використовують технології з вказаноїcategory - categoryТип: string | null
id категорії технології
- groupТип: string | null
id групи технологій
- groupsТип: integer | null Формат: int64
_count кількість груп технологій
кількість доменів, що відповідають вказаним параметрам і використовують технології з вказаноїgroup - technologiesТип: integer | null Формат: int64
_count кількість технологій
кількість доменів, що відповідають вказаним параметрам і використовують вказануtechnology - technologyТип: string | null
назва технології
- typeТип: string | null
тип елемента
- itemsТип: integer | null Формат: int64
_count кількість результатів, повернутих у масиві
items - offsetТип: integer | null
зміщення в масиві результатів повернутих доменів
- totalТип: integer | null Формат: int64
_count загальна кількість результатів у нашій базі даних, що відповідають вашому запиту
- resultТип: integer | null Формат: int64
_count кількість елементів у масиві result
- statusТип: integer | null
_code код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.
- statusТип: string | null
_message інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.
- timeТип: string | null
час виконання, секунди
- Тип: integer | null Формат: int64tasks
_count кількість завдань у масиві tasks
- Тип: integer | null Формат: int64tasks
_error кількість завдань у масиві tasks, повернутих з помилкою
- Тип: string | nulltime
загальний час виконання, секунди
- Тип: string | nullversion
поточна версія API
application/json - 400
Не вдалося обробити запит. Перевірте параметри запиту.
- 401
Потрібен дійсний API-ключ Felo.
- 402
Запит неможливо виконати: умови білінгу не виконано.
- 403
Обліковий запис не має дозволу на цю операцію.
- 429
Досягнуто ліміту запитів або витрат.
- 502
Служба не змогла виконати запит.
- 503
API або служба білінгу тимчасово недоступні.
- 504
Час очікування обробки запиту вичерпано.
- default
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/aggregation_technologies/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"mode": "entry",
"technology": "Nginx",
"keyword": "WordPress",
"filters": [
[
"country_iso_code",
"=",
"US"
],
"and",
[
"domain_rank",
">",
800
]
],
"order_by": [
"groups_count,desc"
],
"limit": 10
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"total_count": null,
"items_count": null,
"offset": null,
"items": [
{
"type": null,
"group": null,
"category": null,
"technology": null,
"groups_count": null,
"categories_count": null,
"technologies_count": null
}
]
}
]
}
]
}