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

Історія зворотних посилань

​

Профіль зворотних посилань одного target на кожну дату діапазону: date_from, date_to і один елемент на точку. Лише для поточного профілю використовуйте post_dataforseo_backlinks_summary_live. Для легшого часового ряду post_dataforseo_backlinks_timeseries_summary_live повідомляє менше показників на точку. Тут немає параметра limit, тому єдиний спосіб зменшити витрати — викликати ендпоінт рідше.

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

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

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

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

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

    • date_to
      Тип: string | null

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

    • rank_scale
      Тип: string | null

      визначає шкалу, яка використовується для розрахунку й відображення значень rank, domain_from_rank і page_from_rank
      необов'язкове поле

      цей параметр дозволяє вибрати, чи подаватимуться значення рангу за шкалою 0–100 або 0–1000

      можливі значення:
      one_hundred — значення рангу відображаються за шкалою 0–100
      one_thousand — значення рангу відображаються за шкалою 0–1000

      значення за замовчуванням: one_thousand

      Як працює цей параметр і як розраховуються метрики ранжування, описано в цій статті Help Center

    • tag
      Тип: string | null

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

    • target
      Тип: string

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

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

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

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

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

          • date_from
            Тип: string | null

            дата початку часового діапазону
            у форматі UTC: “yyyy-mm-dd”
            приклад:
            2019-01-01

          • date_to
            Тип: string | null

            дата закінчення часового діапазону
            у форматі UTC: "yyyy-mm-dd"
            приклад:
            "2019-01-15"

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

            містить історичні дані про зворотні посилання для вказаного домену
            дані надаються помісячно;
            метрики агрегуються за зворотними посиланнями, які вказаний домен мав першого дня кожного заданого місяця

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

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

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

              кількість битих зворотних посилань
              кількість битих зворотних посилань, що вказують на target

            • broken_pages
              Тип: integer | null

              кількість битих сторінок
              кількість сторінок, які отримують зворотні посилання, але відповідають кодами стану 4xx або 5xx

            • crawled_pages
              Тип: integer | null

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

            • date
              Тип: string | null

              дата й час, коли дані для target було збережено
              у форматі UTC: "yyyy-mm-dd hh-mm-ss +00:00"
              приклад:
              2019-11-15 12:57:46 +00:00

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

              кількість зовнішніх посилань на сторінці
              обчислюється як сума зовнішніх посилань на сторінках вказаного target

            • info
              Тип: object | null · Response36Afe1097B20_TargetInfo

              інформація про target

              • cms
                Тип: string | null

                система керування вмістом

              • country
                Тип: string | null

                код країни, до якої, як визначено, належить домен target

              • ip_address
                Тип: string | null

                IP-адреса target

              • is_ip
                Тип: boolean | null

                вказує, чи є target IP-адресою
                якщо true, домен, піддомен або вебсторінка функціонує як IP-адреса й не має доменного імені

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

                тип платформи

              • server
                Тип: string | null

                сервер

              • target_spam_score
                Тип: integer | null

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

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

              кількість внутрішніх посилань
              обчислюється як сума внутрішніх посилань на сторінках вказаного target

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

              кількість втрачених зворотних посилань для target
              дані надаються на основі порівняння з попереднім періодом
              Примітка: ці дані доступні з травня 2021 р.;
              якщо вказаний у POST-запиті діапазон дат передує травню 2021 р., поле дорівнюватиме 0

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

              кількість втрачених доменів, що посилаються, для target
              дані надаються на основі порівняння з попереднім періодом
              Примітка: ці дані доступні з травня 2021 р.;
              якщо вказаний у POST-запиті діапазон дат передує травню 2021 р., поле дорівнюватиме 0

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

              кількість нових зворотних посилань для target
              дані надаються на основі порівняння з попереднім періодом
              Примітка: ці дані доступні з травня 2021 р.;
              якщо вказаний у POST-запиті діапазон дат передує травню 2021 р., поле дорівнюватиме 0

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

              кількість нових доменів, що посилаються, для target
              дані надаються на основі порівняння з попереднім періодом
              Примітка: ці дані доступні з травня 2021 р.;
              якщо вказаний у POST-запиті діапазон дат передує травню 2021 р., поле дорівнюватиме 0

            • rank
              Тип: integer | null

              ранг домену на вказану date
              Докладніше про метрику та спосіб її розрахунку — у цій статті довідкового центру

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

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

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

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

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

              кількість IP-адрес, що посилаються
              кількість IP-адрес, що вказують на цю сторінку

            • referring_links_attributes
              Тип: object | null

              атрибути вхідних посилань
              вказує атрибути вхідних посилань і кількість посилань для кожного атрибута

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

                Signed 64-bit integers (long type).

            • referring_links_countries
              Тип: object | null

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

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

                Signed 64-bit integers (long type).

            • referring_links_platform_types
              Тип: object | null

              типи платформ, що посилаються
              вказує типи платформ, що посилаються, і кількість посилань для кожної платформи

              можливі значення: cms, blogs, ecommerce, message-boards, wikis, news, organization

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

                Signed 64-bit integers (long type).

            • referring_links_semantic_locations
              Тип: object | null

              семантичні розташування вхідних посилань
              вказує семантичні елементи HTML, у яких розташовані вхідні посилання, і кількість посилань для кожного семантичного розташування
              Повний список семантичних елементів можна отримати тут
              приклади:
              article, section, summary

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

                Signed 64-bit integers (long type).

            • referring_links_tld
              Тип: object | null

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

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

                Signed 64-bit integers (long type).

            • referring_links_types
              Тип: object | null

              типи вхідних посилань
              вказує типи вхідних посилань і кількість посилань кожного типу
              можливі значення:
              anchor, image, link, meta, canonical, alternate, redirect

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

                Signed 64-bit integers (long type).

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

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

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

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

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

              кількість сторінок, що вказують на target

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

              кількість сторінок, що посилаються, які передають target щонайменше одне nofollow-посилання

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

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

            • type
              Тип: string | null

              тип елемента

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

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

          • target
            Тип: string | null

            target із POST-масиву

        • 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/backlinks/history/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/history/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "cnn.com",
    "date_from": "2020-01-01",
    "date_to": "2021-01-01"
  }
]'

{
  "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": [
        {
          "target": null,
          "date_from": null,
          "date_to": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "rank": null,
              "backlinks": null,
              "new_backlinks": null,
              "lost_backlinks": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "crawled_pages": null,
              "info": "[Max Depth Exceeded]",
              "internal_links_count": null,
              "external_links_count": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

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

Backlinks History