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 Операції

Історичний огляд рейтингу

​

Огляд рангів домену в кожній точці доступної історії. Тут немає параметра limit, але оплата йде за виклик, а не за елемент, тому надсилайте весь список одразу. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Спершу перевірте get_dataforseo_labs_google_available_history: він називає наявні дати, а запит дати поза ними повертає порожній результат, а не помилку. Поточний знімок — post_dataforseo_labs_google_domain_rank_overview_live.

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

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

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

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

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

    • date_from
      Тип: string | null

      початкова дата часового діапазону
      необов'язкове поле
      якщо не вказати це поле, дані буде надано за попередні 6 місяців
      мінімально можливе значення: 2020-10-01
      формат дати: "yyyy-mm-dd"

    • date_to
      Тип: string | null

      кінцева дата часового діапазону
      необов'язкове поле
      якщо не вказати це поле, за замовчуванням використовуватиметься сьогоднішня дата
      формат дати: "yyyy-mm-dd"
      приклад:
      "2021-04-01"

    • ignore_synonyms
      Тип: boolean | null

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

    • include_clickstream_data
      Тип: boolean | null

      включення або виключення даних клікстрім-метрик у результаті
      необов'язкове поле
      якщо параметр установлено в true, ви отримаєте поля clickstream_etv, clickstream_gender_distribution і clickstream_age_distribution із даними клікстріму у відповіді;
      значення за замовчуванням: false;

      Примітка: історичні дані клікстріму доступні з 2024/05 (травень 2024 р.);
      під час увімкнення цього параметра вартість запиту буде подвоєна;
      докладніше про те, як розраховуються метрики на основі клікстріму, — у цій статті довідкового центру

    • language_code
      Тип: string | null

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

    • language_name
      Тип: string

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

    • location_code
      Тип: integer

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

    • location_name
      Тип: string

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

    • tag
      Тип: string | null

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

    • target
      Тип: string

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

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

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

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

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

            • 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

            • month
              Тип: integer | null

              місяць, за який надано дані

            • se_type
              Тип: string | null

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

            • year
              Тип: integer | 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/historical_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

{
  "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,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

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

Historical Rank Overview