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

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

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]"
            }
          ]
        }
      ]
    }
  ]
}

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

Перетин сторінок

АвтентифікаціяRequired

DataForSEO

Перетин сторінок

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