Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Огляд Whois домену

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

Огляд 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.

Тіло
application/json
  • Тип: 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_token
      Тип: string | null

      токен для наступних запитів
      необов'язкове поле
      надається в тому самому полі відповіді на кожен запит;
      використовуйте цей параметр, щоб уникнути тайм-аутів під час спроби отримати понад 100 000 результатів в одному запиті;
      вказавши унікальне значення offset_token з масиву відповіді, ви отримаєте наступні результати початкового завдання;
      значення offset_token унікальні для кожного наступного завдання
      Примітка: якщо в запиті вказано offset_token, усі інші параметри мають бути ідентичні попередньому запиту
      Докладніше про цей параметр у нашому Help Center

    • order_by
      Тип: array string[] | null

      правила сортування результатів
      необов'язкове поле
      для сортування результатів можна використовувати ті самі значення, що й у масиві 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 відповіді

Відповіді
  • 200
    Тип: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo
    • cost
      Тип: number | null Формат: double

      загальна вартість завдань, USD

    • status_code
      Тип: integer | null

      загальний код стану. Повний список кодів відповіді можна знайти тут.

    • status_message
      Тип: string | null

      загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

    • tasks
      Тип: array (object | null)[] | null

      масив завдань

      • Тип: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveTaskInfo
        • cost
          Тип: number | null Формат: double

          загальна вартість завдань, USD

        • data
          Тип: object | null

          містить ті самі параметри, які ви вказали в POST-запиті

          • propertyName
            Тип: object | null
        • id
          Тип: string | null

          ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

        • path
          Тип: array (string | null)[] | null

          шлях URL

        • result
          Тип: array (object | null)[] | null

          масив результатів

          • items
            Тип: array (object | null)[] | null

            містить дані ранжування й трафіку

            масив items

            • backlinks_info
              Тип: object | null · Response36Afe1097B20_BacklinksInfo

              дані зворотних посилань за повернутим доменом

              • backlinks
                Тип: integer | null Формат: int64

                середня кількість зворотних посилань

              • dofollow
                Тип: integer | null Формат: int64

                середня кількість dofollow-посилань

              • referring_domains
                Тип: integer | null Формат: int64

                середня кількість доменів, що посилаються

              • referring_main_domains
                Тип: integer | null Формат: int64

                середня кількість основних доменів, що посилаються

              • referring_pages
                Тип: integer | null Формат: int64

                середня кількість сторінок, що посилаються

              • time_update
                Тип: string | null

                дата й час оновлення даних про зворотні посилання
                у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”;
                приклад:
                2019-11-15 12:57:46 +00:00

            • changed_datetime
              Тип: string | null

              дата й час зміни запису домену
              дата й час (у форматі ISO 8601), коли запис домену востаннє змінювався
              приклад:
              "2021-01-14 08:36:28 +00:00"

            • created_datetime
              Тип: string | null

              дата й час реєстрації
              дата й час (у форматі ISO 8601), коли домен було вперше зареєстровано
              приклад:
              "1997-03-29 03:00:00 +00:00"

            • domain
              Тип: string | null

              ім'я домену

            • epp_status_codes
              Тип: array (string | null)[] | null

              коди стану протоколу Extensive Provisioning
              статус реєстрації доменного імені згідно з визначенням ICANN

            • expiration_datetime
              Тип: string | null

              дата й час, коли термін дії домену закінчується
              дата й час (у форматі ISO 8601), коли термін дії домену має закінчитися
              приклад:
              "2022-11-26 17:21:23 +00:00"

            • first_seen
              Тип: string | null

              дата й час, коли наш краулер уперше виявив домен
              у форматі 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_paid_traffic_cost
                  Тип: number | null

                  орієнтовна вартість перетворення органічного пошукового трафіку на платний
                  являє собою орієнтовну місячну вартість показу реклами (USD) за всіма ключовими словами, за якими ранжується домен
                  метрика розраховується як добуток значень органічного etv і платного cpc та вказує вартість залучення орієнтовного обсягу місячного органічного трафіку через PPC-рекламу в Google Search
                  докладніше про те, як розраховується метрика, — у цій статті довідкового центру

                • etv
                  Тип: number | null

                  оцінка обсягу трафіку
                  оцінка щомісячного органічного трафіку на домен
                  розраховується як добуток CTR (click-through-rate) і значень пошукового обсягу всіх ключових слів, за якими домен ранжується
                  Докладніше про те, як розраховується ця метрика, — у цій статті довідкового центру

                • is_down
                  Тип: integer | null Формат: int64

                  позиція знизилася указує, скільки ранжованих елементів цього домену знизилися в Google Search

                • is_lost
                  Тип: integer | null Формат: int64

                  втрачені ранжовані елементи указує, скільки ранжованих елементів цього домену раніше були присутні в SERP, але не були знайдені під час останньої перевірки

                • is_new
                  Тип: integer | null Формат: int64

                  кількість нових ранжованих елементів указує, скільки нових ранжованих елементів було знайдено для цього домену

                • is_up
                  Тип: integer | null Формат: int64

                  позиція підвищилася указує, скільки ранжованих елементів цього домену підвищилися в Google Search

                • pos_1
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #1

                • pos_11_20
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #11-20

                • pos_2_3
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #2-3

                • pos_21_30
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #21-30

                • pos_31_40
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #31-40

                • pos_4_10
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #4-10

                • pos_41_50
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #41-50

                • pos_51_60
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #51-60

                • pos_61_70
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #61-70

                • pos_71_80
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #71-80

                • pos_81_90
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #81-90

                • pos_91_100
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #91-100

              • paid
                Тип: object | null · Response36Afe1097B20_MetricsInfo

                дані про позиції та трафік з платного пошуку

                • count
                  Тип: integer | null Формат: int64

                  загальна кількість органічних SERP, що містять домен

                • estimated_paid_traffic_cost
                  Тип: number | null

                  орієнтовна вартість перетворення органічного пошукового трафіку на платний
                  являє собою орієнтовну місячну вартість показу реклами (USD) за всіма ключовими словами, за якими ранжується домен
                  метрика розраховується як добуток значень органічного etv і платного cpc та вказує вартість залучення орієнтовного обсягу місячного органічного трафіку через PPC-рекламу в Google Search
                  докладніше про те, як розраховується метрика, — у цій статті довідкового центру

                • etv
                  Тип: number | null

                  оцінка обсягу трафіку
                  оцінка щомісячного органічного трафіку на домен
                  розраховується як добуток CTR (click-through-rate) і значень пошукового обсягу всіх ключових слів, за якими домен ранжується
                  Докладніше про те, як розраховується ця метрика, — у цій статті довідкового центру

                • is_down
                  Тип: integer | null Формат: int64

                  позиція знизилася указує, скільки ранжованих елементів цього домену знизилися в Google Search

                • is_lost
                  Тип: integer | null Формат: int64

                  втрачені ранжовані елементи указує, скільки ранжованих елементів цього домену раніше були присутні в SERP, але не були знайдені під час останньої перевірки

                • is_new
                  Тип: integer | null Формат: int64

                  кількість нових ранжованих елементів указує, скільки нових ранжованих елементів було знайдено для цього домену

                • is_up
                  Тип: integer | null Формат: int64

                  позиція підвищилася указує, скільки ранжованих елементів цього домену підвищилися в Google Search

                • pos_1
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #1

                • pos_11_20
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #11-20

                • pos_2_3
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #2-3

                • pos_21_30
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #21-30

                • pos_31_40
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #31-40

                • pos_4_10
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #4-10

                • pos_41_50
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #41-50

                • pos_51_60
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #51-60

                • pos_61_70
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #61-70

                • pos_71_80
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #71-80

                • pos_81_90
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #81-90

                • pos_91_100
                  Тип: integer | null

                  кількість органічних SERP, де домен посідає #91-100

            • registered
              Тип: boolean | null

              статус реєстрації домену
              якщо false, термін реєстрації доменного імені минув
              Примітка: прострочені домени залишаються в базі даних лише короткий час

            • registrar
              Тип: string | null

              реєстратор домену
              якщо null, реєстратор домену невідомий
              приклад:
              NameCheap, Inc.

            • tld
              Тип: string | null

              домен верхнього рівня
              домен верхнього рівня в кореневій зоні DNS

            • updated_datetime
              Тип: string | null

              дата й час оновлення домену
              дата й час (у форматі ISO 8601), коли домен востаннє оновлювався
              приклад:
              "2021-01-29 13:59:38 +00:00"

          • items_count
            Тип: integer | null Формат: int64

            кількість результатів, повернутих у масиві items

          • offset
            Тип: integer | null

            значення зміщення результатів, вказане в запиті POST

          • offset_token
            Тип: string | null
          • total_count
            Тип: integer | null Формат: int64

            загальна кількість результатів у нашій базі даних, що відповідають вашому запиту

        • result_count
          Тип: integer | null Формат: int64

          кількість елементів у масиві result

        • status_code
          Тип: integer | null

          код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

        • status_message
          Тип: string | null

          інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

        • time
          Тип: string | null

          час виконання, секунди

    • tasks_count
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks

    • tasks_error
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks, повернутих з помилкою

    • time
      Тип: string | null

      загальний час виконання, секунди

    • version
      Тип: string | null

      поточна версія API

    application/json
  • 400

    Не вдалося обробити запит. Перевірте параметри запиту.

  • 401

    Потрібен дійсний API-ключ Felo.

  • 402

    Запит неможливо виконати: умови білінгу не виконано.

  • 403

    Обліковий запис не має дозволу на цю операцію.

  • 429

    Досягнуто ліміту запитів або витрат.

  • 502

    Служба не змогла виконати запит.

  • 503

    API або служба білінгу тимчасово недоступні.

  • 504

    Час очікування обробки запиту вичерпано.

  • default

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    application/json
Request Example for post/v1/beta/dataforseo/domain_analytics/whois/overview/live
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]"
            }
          ]
        }
      ]
    }
  ]
}

Успішна операція

Domain Whois Overview