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/domain_intersection/live

Перетин доменів

Домени, що посилаються одразу на кілька target. ⚠️ Тут targets — об'єкт із ключами за позицією: {"1": "a.com", "2": "b.com"}, а не масив, як у масових ендпоінтах. exclude_targets виключає сайти з порівняння. Кожен рядок містить domain_intersection і summary для кожного target. Допомагає знайти тих, хто посилається на ваших конкурентів, але не на вас. Аналог на рівні сторінок — post_dataforseo_backlinks_page_intersection_live.

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

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.06.
Довідковий множник для клієнта: 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
 
 задає, які зворотні посилання повертати й обліковувати
 необов'язкове поле
 це поле дозволяє вибрати, які зворотні посилання буде повернено й використано для агрегованих метрик за targets;
 можливі значення:
 all — повертаються й обліковуються всі зворотні посилання;
 live — повертаються й обліковуються зворотні посилання, знайдені під час останньої перевірки;
 lost — повертаються й обліковуються втрачені зворотні посилання;
 
 значення за замовчуванням: live
- exclude_internal_backlinks
 Тип: boolean | null
 
 вказує, чи виключаються зворотні посилання з піддоменів target
 необов'язкове поле
 якщо встановлено false, зворотні посилання з піддоменів target буде пропущено, і ви не отримаєте той самий домен у відповіді;
 значення за замовчуванням: 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.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]
 
 Повний список можливих фільтрів доступний тут.
 
 Порожній об'єкт
- include_indirect_links
 Тип: boolean | null
 
 вказує, чи включаються до результатів непрямі посилання на targets
 необов'язкове поле
 якщо встановлено 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
- intersection_mode
 Тип: string | null
 
 вказує, чи потрібно перетинати зворотні посилання
 необов'язкове поле
 це поле дозволяє перетнути або об'єднати результати для вказаних доменів
 можливі значення: all, partial
 all — результати базуються на всіх зворотних посиланнях;
 partial — результати базуються лише на зворотних посиланнях, що перетинаються;
 значення за замовчуванням: all
- limit
 Тип: integer | null
 
 максимальна кількість результатів, що повертаються
 необов'язкове поле
 значення за замовчуванням: 100
 максимальне значення: 1000
- offset
 Тип: integer | null
 
 зміщення в масиві результатів, що повертаються
 необов'язкове поле
 значення за замовчуванням: 0
 якщо вказати значення 10, перші десять зворотних посилань у масиві результатів буде пропущено, а дані буде надано для наступних зворотних посилань
- order_by
 Тип: array string[] | null
 
 правила сортування результатів
 необов'язкове поле
 для сортування результатів можна використовувати ті самі значення, що й у масиві filters
 можливі типи сортування:
 asc — результати сортуються за зростанням
 desc — результати сортуються за спаданням
 тип сортування вказується через кому
 приклад:
 ["backlinks,desc"]
 в одному запиті можна задати не більше трьох правил сортування
 кілька правил сортування розділяються комою
 приклад:
 ["backlinks,desc","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_BacklinksDomainIntersectionLiveResponseInfo
cost
Тип: number | null Формат: double

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

містить домени, які посилаються на всі targets з POST-масиву

domain_intersection
Тип: object | null

містить дані про домени, які посилаються на відповідні target, вказані в POST-масиві
дані надаються в окремих об'єктах, що відповідають доменам, піддоменам або сторінкам, вказаним в об'єкті targets

propertyName
Тип: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
Тип: integer | null Формат: int64

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

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

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

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

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

broken_pages
Тип: integer | null

кількість битих сторінок

first_seen
Тип: string | null

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

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 із POST-масиву
вказує ранг, який домен, що посилається (target вище), передає вашому target із POST-масиву;
rank розраховується за методом ранжування вузлів у зв'язаній базі даних — принципом, використаним в оригінальному алгоритмі Google PageRank
Докладніше про метрику та спосіб її розрахунку — у цій статті довідкового центру

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

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

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

кількість доменів, що передають відповідному target щонайменше одне nofollow-посилання

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

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

referring_links_attributes
Тип: object | null

атрибути вхідних посилань
вказує атрибути вхідних посилань і кількість посилань для кожного атрибута

propertyName
Тип: integer | null

Integer numbers.

referring_links_countries
Тип: object | null

коди країн ISO вхідних посилань
вказує коди країн ISO доменів, де розташовані вхідні посилання, і кількість посилань для кожної країни

referring_links_platform_types
Тип: object | null

типи платформ, що посилаються
вказує типи платформ, що посилаються, і кількість посилань для кожної платформи

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

propertyName
Тип: integer | null

Integer numbers.

referring_links_semantic_locations
Тип: object | null

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

propertyName
Тип: integer | null

Integer numbers.

referring_links_tld
Тип: object | null

домени верхнього рівня вхідних посилань
містить домени верхнього рівня та кількість вхідних посилань для кожного

propertyName
Тип: integer | null

Integer numbers.

referring_links_types
Тип: object | null

типи вхідних посилань
вказує типи вхідних посилань і кількість посилань кожного типу
можливі значення:
anchor, image, link, meta, canonical, alternate, redirect

propertyName
Тип: integer | null

Integer numbers.

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-масиву

type
Тип: string | null

тип елемента

summary
Тип: object | null · Response36Afe1097B20_IntersectionSummaryInfo

містить зведення перетинів доменів

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

загальна кількість перетинів

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

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

targets
Тип: object | null

цільові домени, піддомени або вебсторінки в 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/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": 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": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

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

Перетин доменів

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

DataForSEO

Перетин доменів

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