DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Обзор Whois домена
Записи Whois, обогащённые SEO-метриками. Каждый элемент содержит domain, created_datetime, changed_datetime, expiration_datetime, updated_datetime, first_seen, epp_status_codes, tld, registered, registrar, а также metrics и backlinks_info. Постранично через limit, offset и offset_token, с фильтрацией по полям из get_dataforseo_domains_whois_available_filters.
Справочная информация о ценах
- Тарификация: заявленная стоимость ответа.
- Справочная оценка запроса: USD 0.012.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: array (object | null)[]
- filtersТип: array (object | null)[] | null
массив параметров фильтрации результатов
необязательное поле
можно добавить несколько фильтров одновременно (не более 8)
между условиями нужно указать логический операторandилиor
поддерживаются следующие операторы:regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
оператор%можно использовать сlikeиnot_likeдля сопоставления любой строки из нуля или более символовПустой объект - limitТип: integer | null
максимальное количество возвращаемых доменов
необязательное поле
значение по умолчанию:100
максимальное значение:1000 - offsetТип: integer | null
смещение в массиве результатов возвращаемых элементов
необязательное поле
значение по умолчанию:0
если указать значение10, первые десятьitemsв массиве результатов будут пропущены, а данные будут предоставлены для последующих элементов;
Примечание: этот параметр рекомендуется использовать только при получении до 10 000 результатов; для получения более 10 000 результатов используйтеoffset_token - offsetТип: string | null
_token токен для последующих запросов
необязательное поле
предоставляется в том же поле ответа на каждый запрос;
используйте этот параметр, чтобы избежать тайм-аутов при попытке получить более 100 000 результатов в одном запросе;
указав уникальное значениеoffset_tokenиз массива ответа, вы получите последующие результаты исходной задачи;
значенияoffset_tokenуникальны для каждой последующей задачи
Примечание: если в запросе указанoffset_token, все остальные параметры должны совпадать с предыдущим запросом
Подробнее об этом параметре в нашем Help Center - orderТип: array string[] | null
_by правила сортировки результатов
необязательное поле
для сортировки результатов можно использовать те же значения, что и в массивеfilters
возможные типы сортировки:asc— результаты сортируются по возрастаниюdesc— результаты сортируются по убыванию
разделителем служит запятая
пример:["metrics.organic.pos_1,desc"]
правило по умолчанию:["metrics.organic.count,desc"]
обратите внимание: в одном запросе можно задать не более трёх правил сортировки
несколько правил сортировки разделяются запятой
пример:["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"] - tagТип: string | null
пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значениеtagвы найдёте в объектеdataответа
- Тип: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo200
- Тип: number | null Формат: doublecost
общая стоимость задач, USD
- Тип: integer | nullstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь.
- Тип: string | nullstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array (object | null)[] | nulltasks
массив задач
- Тип: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveTaskInfo
- 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
- backlinksТип: object | null · Response36Afe1097B20_BacklinksInfo
_info данные обратных ссылок по возвращённому домену
- backlinksТип: integer | null Формат: int64
среднее количество обратных ссылок
- dofollowТип: integer | null Формат: int64
среднее количество dofollow-ссылок
- referringТип: integer | null Формат: int64
_domains среднее количество ссылающихся доменов
- referringТип: integer | null Формат: int64
_main _domains среднее количество ссылающихся основных доменов
- referringТип: integer | null Формат: int64
_pages среднее количество ссылающихся страниц
- timeТип: string | null
_update дата и время обновления данных об обратных ссылках
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”;
пример:2019-11-15 12:57:46 +00:00
- changedТип: string | null
_datetime - createdТип: string | null
_datetime - domainТип: string | null
имя домена
- eppТип: array (string | null)[] | null
_status _codes - expirationТип: string | null
_datetime - firstТип: string | null
_seen дата и время, когда наш краулер впервые обнаружил домен
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:"2019-11-15 12:57:46 +00:00" - metricsТип: object | null · Response36Afe1097B20_MetricsBundleInfo
данные ранжирования, относящиеся к указанному домену
- organicТип: object | null · Response36Afe1097B20_MetricsInfo
данные о позициях и трафике из органического поиска
- countТип: integer | null Формат: int64
общее число органических SERP, содержащих домен
- estimatedТип: number | null
_paid _traffic _cost предполагаемая стоимость превращения органического поискового трафика в платный
представляет предполагаемую месячную стоимость показа рекламы (USD) по всем ключевым словам, по которым ранжируется домен
метрика рассчитывается как произведение значений органическогоetvи платногоcpcи указывает стоимость привлечения предполагаемого объёма месячного органического трафика через PPC-рекламу в Google Search
подробнее о том, как рассчитывается метрика, — в этой статье справочного центра - etvТип: number | null
- isТип: integer | null Формат: int64
_down позиция понизилась указывает, сколько ранжируемых элементов этого домена понизились в Google Search
- isТип: integer | null Формат: int64
_lost потерянные ранжируемые элементы указывает, сколько ранжируемых элементов этого домена ранее присутствовали в SERP, но не были найдены во время последней проверки
- isТип: integer | null Формат: int64
_new количество новых ранжируемых элементов указывает, сколько новых ранжируемых элементов было найдено для этого домена
- isТип: integer | null Формат: int64
_up позиция повысилась указывает, сколько ранжируемых элементов этого домена повысились в Google Search
- posТип: integer | null
_1 количество органических SERP, где домен занимает #1
- posТип: integer | null
_11 _20 количество органических SERP, где домен занимает #11-20
- posТип: integer | null
_2 _3 количество органических SERP, где домен занимает #2-3
- posТип: integer | null
_21 _30 количество органических SERP, где домен занимает #21-30
- posТип: integer | null
_31 _40 количество органических SERP, где домен занимает #31-40
- posТип: integer | null
_4 _10 количество органических SERP, где домен занимает #4-10
- posТип: integer | null
_41 _50 количество органических SERP, где домен занимает #41-50
- posТип: integer | null
_51 _60 количество органических SERP, где домен занимает #51-60
- posТип: integer | null
_61 _70 количество органических SERP, где домен занимает #61-70
- posТип: integer | null
_71 _80 количество органических SERP, где домен занимает #71-80
- posТип: integer | null
_81 _90 количество органических SERP, где домен занимает #81-90
- posТип: integer | null
_91 _100 количество органических SERP, где домен занимает #91-100
- paidТип: object | null · Response36Afe1097B20_MetricsInfo
данные о позициях и трафике из платного поиска
- countТип: integer | null Формат: int64
общее число органических SERP, содержащих домен
- estimatedТип: number | null
_paid _traffic _cost предполагаемая стоимость превращения органического поискового трафика в платный
представляет предполагаемую месячную стоимость показа рекламы (USD) по всем ключевым словам, по которым ранжируется домен
метрика рассчитывается как произведение значений органическогоetvи платногоcpcи указывает стоимость привлечения предполагаемого объёма месячного органического трафика через PPC-рекламу в Google Search
подробнее о том, как рассчитывается метрика, — в этой статье справочного центра - etvТип: number | null
- isТип: integer | null Формат: int64
_down позиция понизилась указывает, сколько ранжируемых элементов этого домена понизились в Google Search
- isТип: integer | null Формат: int64
_lost потерянные ранжируемые элементы указывает, сколько ранжируемых элементов этого домена ранее присутствовали в SERP, но не были найдены во время последней проверки
- isТип: integer | null Формат: int64
_new количество новых ранжируемых элементов указывает, сколько новых ранжируемых элементов было найдено для этого домена
- isТип: integer | null Формат: int64
_up позиция повысилась указывает, сколько ранжируемых элементов этого домена повысились в Google Search
- posТип: integer | null
_1 количество органических SERP, где домен занимает #1
- posТип: integer | null
_11 _20 количество органических SERP, где домен занимает #11-20
- posТип: integer | null
_2 _3 количество органических SERP, где домен занимает #2-3
- posТип: integer | null
_21 _30 количество органических SERP, где домен занимает #21-30
- posТип: integer | null
_31 _40 количество органических SERP, где домен занимает #31-40
- posТип: integer | null
_4 _10 количество органических SERP, где домен занимает #4-10
- posТип: integer | null
_41 _50 количество органических SERP, где домен занимает #41-50
- posТип: integer | null
_51 _60 количество органических SERP, где домен занимает #51-60
- posТип: integer | null
_61 _70 количество органических SERP, где домен занимает #61-70
- posТип: integer | null
_71 _80 количество органических SERP, где домен занимает #71-80
- posТип: integer | null
_81 _90 количество органических SERP, где домен занимает #81-90
- posТип: integer | null
_91 _100 количество органических SERP, где домен занимает #91-100
- registeredТип: boolean | null
статус регистрации домена
еслиfalse, срок регистрации доменного имени истёк
Примечание: просроченные домены остаются в базе данных лишь на короткое время - registrarТип: string | null
регистратор домена
еслиnull, регистратор домена неизвестен
пример:NameCheap, Inc. - tldТип: string | null
- updatedТип: string | null
_datetime
- itemsТип: integer | null Формат: int64
_count количество результатов, возвращённых в массиве
items - offsetТип: integer | null
значение смещения результатов, указанное в запросе POST
- offsetТип: string | null
_token - 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
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/whois/overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"limit": 2,
"filters": [
[
"epp_status_codes",
"in",
[
"client_transfer_prohibited",
"client_update_prohibited"
]
]
]
}
]'
{
"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,
"offset_token": null,
"items": [
{
"domain": null,
"created_datetime": null,
"changed_datetime": null,
"expiration_datetime": null,
"updated_datetime": null,
"first_seen": null,
"epp_status_codes": [
"[Max Depth Exceeded]"
],
"tld": null,
"registered": null,
"registrar": null,
"metrics": "[Max Depth Exceeded]",
"backlinks_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}