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

post/v1/beta/dataforseo/backlinks/page_intersection/live

Пересечение страниц

Страницы, ссылающиеся сразу на несколько target URL, а не домены. ⚠️ targets — объект с ключами по позиции, принимает полные URL, а не голые домены. Каждая строка содержит page_intersection и summary по каждому target. Аналог на уровне доменов — post_dataforseo_backlinks_domain_intersection_live, с него и стоит начинать.

Справочные цены

Тарификация: стоимость ответа по данным провайдера.
Справочная оценка запроса: USD 0.033.
Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Тело

application/json

Тип: array (object | null)[]
- backlinks_status_type
 Тип: string | null
 
 задаёт, какие обратные ссылки возвращать и учитывать
 необязательное поле
 это поле позволяет выбрать, какие обратные ссылки будут возвращены и использованы для агрегированных метрик по targets;
 возможные значения:
 all — возвращаются и учитываются все обратные ссылки;
 live — возвращаются и учитываются обратные ссылки, найденные при последней проверке;
 lost — возвращаются и учитываются потерянные обратные ссылки;
 
 значение по умолчанию: live
- exclude_internal_backlinks
 Тип: boolean | null
 
 указывает, исключаются ли из результатов внутренние обратные ссылки с поддоменов на target
 необязательное поле
 если задано true, результаты не будут содержать данные о внутренних обратных ссылках с поддоменов того же домена, что и target
 если задано false, внутренние ссылки будут включены в результат
 значение по умолчанию: true
- exclude_targets
 Тип: array string[] | null
 
 домены, поддомены или веб-страницы, которые нужно исключить
 необязательное поле
 можно указать до 10 доменов, поддоменов или веб-страниц
 если использовать этот массив, результаты будут содержать ссылающиеся страницы, которые ссылаются на targets, но не ссылаются на exclude_targets
 пример:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- filters
 Тип: array (object | null)[] | null
 
 массив параметров фильтрации результатов
 необязательное поле
 можно добавить несколько фильтров сразу (не более 8)
 между условиями нужно указать логический оператор and или or
 поддерживаются следующие операторы:
 regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
 оператор % можно использовать с like и not_like, чтобы сопоставить любую строку из нуля или более символов
 пример:
 ["1.rank",">","80"]
 
 [["2.page_from_rank",">","55"], "and", ["1.original","=","true"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]
 
 Полный список возможных фильтров доступен здесь.
 
 Пустой объект
- include_indirect_links
 Тип: boolean | null
 
 указывает, включаются ли в результаты косвенные ссылки на targets
 необязательное поле
 если задано true, результаты будут содержать данные о косвенных ссылках, ведущих на страницу, которая перенаправляет на target или указывает на каноническую страницу
 если задано false, косвенные ссылки игнорируются
 значение по умолчанию: true
- include_subdomains
 Тип: boolean | null
 
 указывает, включаются ли поддомены targets в поиск
 необязательное поле
 если задано false, поддомены игнорируются
 значение по умолчанию: true
- internal_list_limit
 Тип: integer | null
 
 максимальное количество элементов во внутренних массивах
 необязательное поле
 это поле ограничивает количество элементов в следующих массивах:
 attributes
 domain_from_platform_type
 
 значение по умолчанию: 10
 максимальное значение: 1000
- intersection_mode
 Тип: string | null
 
 указывает, нужно ли пересекать обратные ссылки
 необязательное поле
 это поле позволяет пересечь или объединить результаты для указанных URL
 возможные значения: all, partial
 all — результаты основаны на всех обратных ссылках;
 partial — результаты основаны только на пересекающихся обратных ссылках;
 значение по умолчанию: all
- limit
 Тип: integer | null
 
 максимальное количество возвращаемых обратных ссылок
 необязательное поле
 
 значение по умолчанию: 100
 максимальное значение: 1000
- offset
 Тип: integer | null
 
 смещение в массиве результатов возвращаемых обратных ссылок
 необязательное поле
 
 значение по умолчанию: 0
 если указать значение 10, первые десять обратных ссылок в массиве результатов будут пропущены, а данные будут предоставлены для последующих обратных ссылок
- 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
- tag
 Тип: string | null
 
 пользовательский идентификатор задачи
 необязательное поле
 ограничение — 255 символов
 этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
 указанное значение tag вы найдёте в объекте data ответа
- targets
 Тип: object | null
 
 домены, поддомены или веб-страницы, для которых нужно получить ссылки
 обязательное поле
 можно указать до 20 доменов, поддоменов или веб-страниц
 домен или поддомен указывается без https:// и www.
 страница указывается абсолютным URL (включая http:// или https://)
 пример:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Тип: string | null

Ответы

200
Тип: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
cost
Тип: number | null Формат: double

общая стоимость задач, USD

status_code
Тип: integer | null

общий код состояния. Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.

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

массив задач

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

содержит релевантные данные об обратных ссылках и ссылающихся доменах

page_intersection
Тип: object | null

содержит данные о страницах, которые ссылаются на соответствующие target, указанные в POST-массиве
данные предоставляются в отдельных объектах, соответствующих страницам, указанным в объекте targets

propertyName
Тип: 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, это поле будет указывать общее количество обратных ссылок, приходящих с этого домена

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, link, 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

ранг обратной ссылки
rank рассчитывается по методу ранжирования узлов в связанной базе данных — принципу, использованному в оригинальном алгоритме Google PageRank
Подробнее о метрике и способе её расчёта — в этой статье справочного центра

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

summary
Тип: object | null · Response36Afe1097B20_IntersectionSummaryInfo

содержит сводку пересечений страниц

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

общее число пересечений

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

количество результатов, возвращённых в массиве items

targets
Тип: object | null

targets из POST-массива

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

post/v1/beta/dataforseo/backlinks/page_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'

Показать схему

{
  "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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

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

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

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

Пересечение страниц

АутентификацияRequired

DataForSEO

Пересечение страниц

Справочные цены

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