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

Огляд рангів домену

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

DataForSEO

​

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

DataForSEO Операції

Огляд рангів домену

​

Пошукова присутність домену: кількість органічних і платних ключових слів, оцінка трафіку та вартість трафіку за location_code. Повертає se_type, target, total_count, items_count і items. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Ті самі цифри в часі — post_dataforseo_labs_google_historical_rank_live; одразу для багатьох доменів — post_dataforseo_labs_google_bulk_traffic_estimation_live.

Довідкові ціни

  • Тарифікація: вартість відповіді за даними постачальника.
  • Довідкова оцінка запиту: USD 0.0121.
  • Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло
application/json
  • Тип: array (object | null)[]
    • ignore_synonyms
      Тип: boolean | null

      ігнорувати дуже схожі ключові слова
      необов'язкове поле
      якщо встановлено true, усі дуже схожі ключові слова буде виключено з розрахунків ранжування й трафіку, результати ґрунтуватимуться на даних основних ключових слів із груп синонімів
      значення за замовчуванням: false

    • language_code
      Тип: string | null

      код мови
      необов'язкове поле
      якщо використовуєте це поле, language_name вказувати не потрібно
      список доступних мов із language_code можна отримати окремим запитом до
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ігноруйте це поле, щоб отримати результати для всіх доступних мов
      приклад:
      en

    • language_name
      Тип: string | null

      повна назва мови
      необов'язкове поле
      якщо використовуєте це поле, language_code вказувати не потрібно
      список доступних мов із language_name можна отримати окремим запитом до
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ігноруйте це поле, щоб отримати результати для всіх доступних мов
      приклад:
      English

    • limit
      Тип: integer | null

      максимальна кількість результатів, що повертаються, для домену
      необов'язкове поле
      значення за замовчуванням: 100
      максимальне значення: 1000

    • location_code
      Тип: integer | null

      код місцезнаходження
      необов'язкове поле
      якщо використовуєте це поле, location_name вказувати не потрібно
      список доступних місцезнаходжень із location_code можна отримати окремим запитом до
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ігноруйте це поле, щоб отримати результати для всіх доступних місцезнаходжень
      приклад:
      2840

    • location_name
      Тип: string | null

      повна назва місцезнаходження
      необов'язкове поле
      якщо використовуєте це поле, location_code вказувати не потрібно
      список доступних місцезнаходжень із location_name можна отримати окремим запитом до
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ігноруйте це поле, щоб отримати результати для всіх доступних місцезнаходжень
      приклад:
      United Kingdom

    • offset
      Тип: integer | null

      зміщення в масиві результатів елементів, що повертаються
      необов'язкове поле
      значення за замовчуванням: 0
      якщо вказати значення 10, перші десять items у масиві результатів буде пропущено, а дані буде надано для наступних елементів

    • tag
      Тип: string | null

      визначений користувачем ідентифікатор завдання
      необов'язкове поле
      обмеження — 255 символів
      цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
      вказане значення tag ви знайдете в об'єкті data відповіді

    • target
      Тип: string

      домен
      обов'язкове поле
      назва домену цільового вебсайту
      домен вказується без https:// і www.

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

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

      • Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
        • 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

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

            • language_code
              Тип: string | null

              код мови в масиві POST

            • location_code
              Тип: integer | null

              код місцеположення в масиві POST

            • metrics
              Тип: object | null

              дані ранжування, що стосуються вказаного домену

              • propertyName
                Тип: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Тип: object | null

                  розподіл метрик на основі клікстріму за віком
                  щоб отримати результати для цього поля, параметр include_clickstream_data має бути встановлений у true
                  докладніше про те, як розраховується метрика, — у цій статті довідкового центру

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

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Тип: number | null Формат: double

                  оцінка обсягу трафіку на основі даних клікстріму
                  розраховується як добуток значень клікабельності та пошукового обсягу клікстріму за всіма ключовими словами, за якими ранжується домен
                  щоб отримати результати для цього поля, параметр include_clickstream_data має бути встановлений у true
                  докладніше про те, як розраховується метрика, — у цій статті довідкового центру

                • clickstream_gender_distribution
                  Тип: object | null

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

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

                    Signed 64-bit integers (long type).

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

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

                • estimated_paid_traffic_cost
                  Тип: number | null

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

                • etv
                  Тип: number | null

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

                • is_down
                  Тип: integer | null

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

                • is_lost
                  Тип: integer | null

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

                • is_new
                  Тип: integer | null

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

                • is_up
                  Тип: integer | null

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

                • 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

            • se_type
              Тип: string | null

              тип пошукової системи

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

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

          • language_code
            Тип: string | null

            код мови в масиві POST

          • location_code
            Тип: integer | null

            код місцеположення в масиві POST

          • se_type
            Тип: string | null

            тип пошукової системи

          • target
            Тип: string | null

            цільовий домен у POST-масиві

          • 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/dataforseo_labs/google/domain_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840
  }
]'

{
  "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": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "location_code": null,
              "language_code": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

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

Domain Rank Overview