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

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

Нові та втрачені домени, що посилаються, для багатьох targets від date_from: new_referring_domains, lost_referring_domains, new_referring_main_domains і lost_referring_main_domains для кожного target. Якщо треба зрозуміти, чи справді сайт нарощує зв'язки, надавайте перевагу цьому ендпоінту над post_dataforseo_backlinks_bulk_new_lost_backlinks_live: домени змінюються рідше за посилання. Тут немає параметра limit, тому єдиний спосіб зменшити витрати — викликати ендпоінт рідше.

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

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.06.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло

application/json

Тип: array (object | null)[]
- date_from
 Тип: string | null
 
 початкова дата часового діапазону
 необов'язкове поле
 це поле вказує дату, яка використовуватиметься як поріг для нових і втрачених доменів, що посилаються;
 домени, що посилаються, які з'явилися в нашому індексі після вказаної дати, вважаються новими;
 домени, що посилаються, не знайдені після вказаної дати, але присутні раніше, вважаються втраченими;
 
 значення за замовчуванням: сьогоднішня дата мінус один місяць;
 наприклад, якщо сьогодні 2021-10-13, значення date_from за замовчуванням буде 2021-09-13.
 мінімальне значення дорівнює сьогоднішній даті мінус один рік;
 наприклад, якщо сьогодні 2021-10-13, мінімальне date_from буде 2020-10-13.
 
 формат дати: "yyyy-mm-dd"
 приклад:
 "2021-01-01"
- tag
 Тип: string | null
 
 визначений користувачем ідентифікатор завдання
 необов'язкове поле
 обмеження — 255 символів
 цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
 вказане значення tag ви знайдете в об'єкті data відповіді
- targets
 Тип: array string[]
 
 домени, піддомени або вебсторінки, для яких потрібно отримати нові та втрачені домени, що посилаються
 обов'язкове поле
 можна вказати до 1000 доменів, піддоменів або вебсторінок
 домен або піддомен вказується без https:// і www.
 сторінка вказується абсолютним URL (включно з http:// або https://)
 приклад:
 "targets": [ "forbes.com", "cnn.com", "bbc.com", "yelp.com", "https://www.apple.com/iphone/", "https://ahrefs.com/blog/", "ibm.com", "https://variety.com/", "https://stackoverflow.com/", "www.trustpilot.com" ]

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

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

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

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

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

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

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

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

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

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

target
Тип: string | null

домен, піддомен або вебсторінка з POST-масиву

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

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_new_lost_referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "forbes.com",
      "cnn.com",
      "bbc.com",
      "yelp.com",
      "https://www.apple.com/iphone/",
      "https://ahrefs.com/blog/",
      "ibm.com",
      "https://variety.com/",
      "https://stackoverflow.com/",
      "www.trustpilot.com"
    ],
    "datetime_from": "2026-12-31"
  }
]'

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

{
  "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": [
        {
          "items_count": null,
          "items": [
            {
              "target": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "new_referring_main_domains": null,
              "lost_referring_main_domains": null
            }
          ]
        }
      ]
    }
  ]
}

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

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

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

DataForSEO

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

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