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

Сторінки домену

Сторінки одного target, на які ведуть посилання, з даними краулера для кожної: main_domain, domain, tld, page, ip, first_visited, prev_visited і fetch_time. Показує, які сторінки справді отримують посилання. Для кількості зворотних посилань за сторінками, а не метаданих обходу, використовуйте post_dataforseo_backlinks_domain_pages_summary_live.

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

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.0276.
Довідковий множник для клієнта: 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
  
  задає, які зворотні посилання повертати й обліковувати
  необов'язкове поле
  це поле дозволяє вибрати, які зворотні посилання буде повернено й використано для агрегованих метрик;
  можливі значення:
  all — повертаються й обліковуються всі зворотні посилання;
  live — повертаються й обліковуються зворотні посилання, знайдені під час останньої перевірки;
  lost — повертаються й обліковуються втрачені зворотні посилання;
  
  значення за замовчуванням: live
- exclude_internal_backlinks
  Тип: boolean | null
  
  вказує, чи виключаються з результатів внутрішні зворотні посилання з піддоменів на target
  необов'язкове поле
  якщо встановлено true, результати не міститимуть даних про внутрішні зворотні посилання з піддоменів того самого домену, що й target
  якщо встановлено false, внутрішні посилання буде включено до результатів
  значення за замовчуванням: true
- 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, щоб зіставити будь-який рядок із нуля або більше символів
  приклад:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  Повний список можливих фільтрів доступний тут.
  
  Порожній об'єкт
- 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
- limit
  Тип: integer | null
  
  максимальна кількість повернутих сторінок
  необов'язкове поле
  значення за замовчуванням: 100
  максимальне значення: 1000
- offset
  Тип: integer | null
  
  зміщення в масиві результатів повернутих сторінок
  необов'язкове поле
  значення за замовчуванням: 0
  якщо вказати значення 10, перші десять сторінок у масиві результатів буде пропущено, а дані буде надано для наступних сторінок
- order_by
  Тип: array string[] | null
  
  правила сортування результатів
  необов'язкове поле
  для сортування результатів можна використовувати ті самі значення, що й у масиві filters
  можливі типи сортування:
  asc — результати сортуються за зростанням
  desc — результати сортуються за спаданням
  тип сортування вказується через кому
  приклад:
  ["page_summary.backlinks,desc"]
  в одному запиті можна задати не більше трьох правил сортування
  кілька правил сортування розділяються комою
  приклад:
  ["page_summary.backlinks,desc","page_summary.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 відповіді
- target
  Тип: string
  
  домен або піддомен
  обов'язкове поле
  домен або піддомен вказується без https:// і www.
  приклад:
  forbes.com

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

масив елементів

content_encoding
Тип: string | null

тип кодування

domain
Тип: string | null

домен
домен, на якому знайдено сторінку

encoded_size
Тип: integer | null

розмір сторінки після кодування
вказує розмір закодованої сторінки в байтах

fetch_time
Тип: string | null

найновіша дата й час відвідування сторінки нашим краулером
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2017-01-24 13:20:59 +00:00

first_visited
Тип: string | null

дата й час першого відвідування сторінки
дата й час, коли наш краулер уперше відвідав цю сторінку
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2017-01-24 13:20:59 +00:00

ip
Тип: string | null

IP-адреса

location
Тип: string | null

заголовок location
вказує URL, на який слід перенаправити сторінку, якщо він існує

main_domain
Тип: string | null

основний домен сайту
основний домен сайту не включає піддомени

media_type
Тип: string | null

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

meta
Тип: object | null · Response36Afe1097B20_BacklinksPageMeta

метадані сторінки

canonical
Тип: string | null

канонічна сторінка

charset
Тип: string | null

кодування символів
приклади:
utf-8

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

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

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

тег h1
вміст тегів h1

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

тег h2
вміст тегів h2

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

тег h3
вміст тегів h3

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

вміст тегів alt

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

кількість зображень на сторінці

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

кількість внутрішніх посилань на сторінці

language
Тип: string | null

мова вмісту сторінки
приклад:
en

page_spam_score
Тип: integer | null

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

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

тип платформи

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

відомості про CMS

social_media_tags
Тип: object | null
propertyName
Тип: string | null
technologies
Тип: object | null

технології сайту

propertyName
Тип: string | null
title
Тип: string | null

заголовок сторінки

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

кількість слів на сторінці

page
Тип: string | null

URL сторінки
URL відповідної сторінки

page_summary
Тип: object | null · Response36Afe1097B20_PageSummary

містить дані про зворотні посилання для цієї сторінки

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

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

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

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

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

кількість битих зворотних посилань
кількість битих зворотних посилань, що ведуть на page

broken_pages
Тип: integer | null

кількість битих сторінок
кількість сторінок, що відповідають кодами стану 4xx або 5xx, на які вказують зворотні посилання

first_seen
Тип: string | null

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

lost_date
Тип: string | null

дата й час втрати останнього зворотного посилання для цієї сторінки
указує дату й час, коли наш сканер відвідав сторінку і вона відповіла кодом стану 4xx або 5xx, або коли останнє зворотне посилання було видалено
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2017-01-24 13:20:59 +00:00

rank
Тип: integer | null

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

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

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

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

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

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

кількість IP-адрес, що посилаються
кількість IP-адрес, що вказують на цю сторінку

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

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

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

Signed 64-bit integers (long type).

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

указує кількість сторінок, що ведуть на page

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

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

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

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

prev_visited
Тип: string | null

дата, що передує найновішому відвідуванню сторінки нашим краулером
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2017-01-24 13:20:59 +00:00

server
Тип: string | null

версія сервера

size
Тип: integer | null

вказує розмір сторінки в байтах

status_code
Тип: integer | null

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

tld
Тип: string | null

домен верхнього рівня
домен верхнього рівня в кореневій зоні DNS

type
Тип: string | null

тип елемента

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

кількість елементів у масиві items

target
Тип: string | null

target у 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

post/v1/beta/dataforseo/backlinks/domain_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

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

{
  "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,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

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

Сторінки домену

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

DataForSEO

Сторінки домену

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