Felo API PlatformFelo API Platform
Все эндпоинты 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

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    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

Нужна помощь?