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 за один виклик: first_seen, lost_date, rank, backlinks, backlinks_spam_score, crawled_pages, internal_links_count і блок info, а також лічильники доменів, що посилаються, та анкорів. Це центр сімейства: починайте тут, потім заглиблюйтеся в потрібну частину — post_dataforseo_backlinks_backlinks_live для окремих посилань, post_dataforseo_backlinks_referring_domains_live для того, хто посилається, post_dataforseo_backlinks_anchors_live для використовуваного тексту. Тут немає параметра limit, тому єдиний спосіб зменшити витрати — викликати ендпоінт рідше.

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

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

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

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

      фільтрує зворотні посилання вашого target
      необов'язкове поле
      це поле дозволяє відфільтрувати початкові зворотні посилання, які увійдуть до набору даних для агрегованих метрик за вашим target
      зворотні посилання можна фільтрувати за всіма полями, доступними у відповіді цього ендпоінта
      за допомогою цього параметра можна включити до відповіді лише dofollow-зворотні посилання й створити гнучкий набір даних зворотних посилань для розрахунку метрик
      приклад:
      "backlinks_filters": ["dofollow", "=", true]

      Порожній об'єкт
    • backlinks_status_type
      Тип: string | null

      вибір зворотних посилань, які повертаються та враховуються
      необов'язкове поле
      це поле дозволяє вибрати, які зворотні посилання будуть повернені та використані для агрегованих метрик за вашим target;
      можливі значення:
      all — повертаються та враховуються всі зворотні посилання;
      live — повертаються та враховуються зворотні посилання, знайдені під час останньої перевірки;
      lost — повертаються та враховуються втрачені зворотні посилання;

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

    • exclude_internal_backlinks
      Тип: boolean | null

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

    • include_indirect_links
      Тип: boolean | null

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

    • include_subdomains
      Тип: boolean | null

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

    • internal_list_limit
      Тип: integer | null

      максимальна кількість елементів у внутрішніх масивах
      необов'язкове поле
      це поле обмежує кількість елементів у таких масивах:
      referring_links_tld
      referring_links_types
      referring_links_attributes
      referring_links_platform_types
      referring_links_semantic_locations

      значення за замовчуванням: 10
      максимальне значення: 1000

    • 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.
      сторінка вказується абсолютним URL (включно з http:// або https://)

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

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

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

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

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

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

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

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

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

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

          • broken_pages
            Тип: integer | null

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

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

          • crawled_pages
            Тип: integer | null

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

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

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

          • first_seen
            Тип: string | null

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

          • 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_date
            Тип: string | null

            дата й час, коли зворотне посилання було втрачено
            вказує дату й час, коли наш краулер відвідав target і він відповів кодом стану 4xx або 5xx, або коли його останнє зворотне посилання було видалено
            у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            приклад:
            2019-11-15 12:57:46 +00:00

          • rank
            Тип: integer | null

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

          • 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

            атрибути вхідних посилань
            вказує атрибути вхідних посилань і кількість посилань для кожного атрибута
            приклади значень:
            nofollow, noopener, noreferrer, external, ugc, sponsored

            • 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

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

          • 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/summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "explodingtopics.com",
    "internal_list_limit": 10,
    "include_subdomains": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "backlinks_status_type": "all"
  }
]'

{
  "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,
          "first_seen": null,
          "lost_date": null,
          "rank": null,
          "backlinks": null,
          "backlinks_spam_score": null,
          "crawled_pages": null,
          "info": {
            "server": null,
            "cms": null,
            "platform_type": [
              "[Max Depth Exceeded]"
            ],
            "ip_address": null,
            "country": null,
            "is_ip": null,
            "target_spam_score": null
          },
          "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 Summary