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: один рядок на посилання. Повертає total_count, items_count, items і search_after_token для посторінкового виводу — використовуйте його замість offset після перших кількох сторінок. mode і custom_mode керують групуванням, backlinks_status_type вибирає live, lost або all. Для лічильників замість рядків використовуйте post_dataforseo_backlinks_summary_live, для згрупованих доменів, що посилаються, — post_dataforseo_backlinks_referring_domains_live.

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

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

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

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

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

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

    • custom_mode
      Тип: object | null

      тип групування докладних результатів
      необов'язкове поле
      цей об'єкт дозволяє отримати задану кількість зворотних посилань для кожного field
      якщо використовується custom_mode, то mode ігнорується
      приклад:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        Тип: object | null
    • exclude_internal_backlinks
      Тип: boolean | null

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

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

      масив параметрів фільтрації результатів
      необов'язкове поле
      можна додати кілька фільтрів одразу (не більше 8)
      між умовами потрібно вказати логічний оператор and або or
      підтримуються такі оператори:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
      оператор % можна використовувати з like і not_like, щоб зіставити будь-який рядок із нуля або більше символів
      приклад:
      ["rank",">","80"]

      [["page_from_rank",">","55"],
      "and",
      ["dofollow","=",true]]

      [["first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]

      Повний список можливих фільтрів доступний тут.

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

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

    • limit
      Тип: integer | null

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

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

    • mode
      Тип: string | null

      тип групування результатів
      необов'язкове поле
      можливі типи групування:
      as_is — повертаються всі зворотні посилання
      one_per_domain — повертається одне зворотне посилання на домен
      one_per_anchor — повертається одне зворотне посилання на анкор

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

    • offset
      Тип: integer | null

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

      значення за замовчуванням: 0
      якщо вказати значення 10, перші десять зворотних посилань у масиві результатів буде пропущено, а дані буде надано для наступних зворотних посилань;
      Примітка: максимальне значення — 20,000; якщо потрібно змістити більше результатів, використовуйте search_after_token

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

      правила сортування результатів
      необов'язкове поле
      для сортування результатів можна використовувати ті самі значення, що й у масиві filters
      можливі типи сортування:
      asc — результати сортуються за зростанням
      desc — результати сортуються за спаданням
      тип сортування вказується через кому
      приклад:
      ["rank,desc"]
      в одному запиті можна задати не більше трьох правил сортування
      кілька правил сортування розділяються комою
      приклад:
      ["domain_from_rank,desc","page_from_rank,asc"]

    • 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

    • search_after_token
      Тип: string | null

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

    • tag
      Тип: string | null

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

    • target
      Тип: string

      домен, піддомен або вебсторінка, для яких потрібно отримати зворотні посилання
      обов'язкове поле
      домен або піддомен вказується без https:// і www.
      сторінка вказується абсолютним URL (включно з http:// або https://)

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

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

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

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

          • custom_mode
            Тип: object | null

            користувацький режим, вказаний у POST-масиві

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

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

            • alt
              Тип: string | null

              альтернативний текст зображення
              це поле буде null, якщо type зворотного посилання не image

            • anchor
              Тип: string | null

              анкорний текст зворотного посилання

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

              атрибути вхідних посилань
              приклад:
              nofollow

            • backlink_spam_score
              Тип: integer | null

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

            • dofollow
              Тип: boolean | null

              вказує, чи є зворотне посилання dofollow
              якщо false, зворотне посилання — nofollow

            • domain_from
              Тип: string | null

              домен, що посилається на цільовий домен або вебсторінку

            • domain_from_country
              Тип: string | null

              код країни ISO домену, що посилається

            • domain_from_ip
              Тип: string | null

              IP-адреса домену, що посилається

            • domain_from_is_ip
              Тип: boolean | null

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

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

              типи платформ домену, що посилається

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

            • domain_from_rank
              Тип: integer | null

              ранг домену, що посилається
              domain_from_rank розраховується за методом ранжування вузлів у зв'язаній базі даних — принципом, використаним в оригінальному алгоритмі Google PageRank
              Докладніше про метрику та спосіб її розрахунку — у цій статті довідкового центру

            • domain_to
              Тип: string | null

              домен, на який указує зворотне посилання

            • first_seen
              Тип: string | null

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

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

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

            • image_url
              Тип: string | null

              URL зображення
              URL, що веде до зображення на вихідному ресурсі або в сховищі DataForSEO (якщо вихідне джерело недоступне)

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

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

              • status_code
                Тип: integer | null

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

              • type
                Тип: string | null

                тип елемента

              • url
                Тип: string | null

                URL непрямого посилання

            • is_broken
              Тип: boolean | null

              вказує, чи є зворотне посилання битим
              якщо true, зворотне посилання вказує на сторінку, що відповідає кодом стану 4xx або 5xx

            • is_indirect_link
              Тип: boolean | null

              вказує, чи є зворотне посилання непрямим
              якщо true, зворотне посилання є непрямим посиланням на сторінку, яка або перенаправляє на url_to, або вказує на канонічну сторінку

            • is_lost
              Тип: boolean | null

              вказує, чи було зворотне посилання видалено
              якщо true, зворотне посилання або всю сторінку було видалено

            • is_new
              Тип: boolean | null

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

            • item_type
              Тип: string | null

              тип посилання
              можливі значення:
              anchor, image, meta, canonical, alternate, redirect

            • last_seen
              Тип: string | null

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

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

              кількість ідентичних зворотних посилань, знайдених на сторінці, що посилається

            • original
              Тип: boolean | null

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

            • page_from_encoding
              Тип: string | null

              кодування символів сторінки, що посилається
              приклад:
              utf-8

            • page_from_external_links
              Тип: integer | null

              кількість зовнішніх посилань, знайдених на сторінці, що посилається

            • page_from_internal_links
              Тип: integer | null

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

            • page_from_language
              Тип: string | null

              мова сторінки, що посилається
              у форматі ISO 639-1
              приклад:
              en

            • page_from_rank
              Тип: integer | null

              ранг сторінки, що посилається
              page_from_rank розраховується за методом ранжування вузлів у зв'язаній базі даних — принципом, використаним в оригінальному алгоритмі Google PageRank
              Докладніше про метрику та спосіб її розрахунку — у цій статті довідкового центру

            • page_from_size
              Тип: integer | null

              розмір сторінки, що посилається, у байтах
              приклад:
              63357

            • page_from_status_code
              Тип: integer | null

              код стану HTTP, який повертає сторінка, що посилається
              приклад:
              200

            • page_from_title
              Тип: string | null

              заголовок сторінки, що посилається

            • prev_seen
              Тип: string | null

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

            • rank
              Тип: integer | null

              ранг зворотного посилання
              ранг, який це зворотне посилання передає target
              rank розраховується за методом ранжування вузлів у зв'язаній базі даних — принципом, використаним в оригінальному алгоритмі Google PageRank
              Докладніше про метрику та спосіб її розрахунку — у цій статті довідкового центру

            • ranked_keywords_info
              Тип: object | null · Response36Afe1097B20_RankedKeywordsInfo
              • page_from_keywords_count_top_10
                Тип: integer | null Формат: int64

                Signed 64-bit integers (long type).

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

                Signed 64-bit integers (long type).

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

                Signed 64-bit integers (long type).

            • semantic_location
              Тип: string | null

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

            • text_post
              Тип: string | null

              фрагмент після анкорного тексту

            • text_pre
              Тип: string | null

              фрагмент перед анкорним текстом

            • tld_from
              Тип: string | null

              домен верхнього рівня URL, що посилається

            • type
              Тип: string | null

              тип елемента

            • url_from
              Тип: string | null

              URL сторінки, на якій знайдено зворотне посилання

            • url_from_https
              Тип: boolean | null

              вказує, чи захищений URL, що посилається, за допомогою HTTPS
              якщо true, URL, що посилається, захищений за допомогою HTTPS

            • url_to
              Тип: string | null

              URL, на який указує зворотне посилання

            • url_to_https
              Тип: boolean | null

              вказує, чи захищений URL, на який указує зворотне посилання, за допомогою HTTPS
              якщо true, URL захищений за допомогою HTTPS

            • url_to_redirect_target
              Тип: string | null

              цільовий URL перенаправлення
              цільова сторінка, на яку вказує перенаправлення

            • url_to_spam_score
              Тип: integer | null

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

            • url_to_status_code
              Тип: integer | null

              код стану сторінки, на яку веде посилання
              якщо значення — null, наш краулер ще не відвідав вебсторінку, на яку вказує посилання
              приклад:
              200

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

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

          • mode
            Тип: string | null

            режим, вказаний у POST-масиві

          • search_after_token
            Тип: string | null

            токен для наступних запитів
            якщо під час створення нового завдання вказати унікальний search_after_token, ви отримаєте наступні результати початкового завдання;
            значення search_after_token унікальні для кожного наступного завдання

          • 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/backlinks/backlinks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

{
  "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,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

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

Backlinks