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

Зведений часовий ряд нових і втрачених зворотних посилань

Нові та втрачені зворотні посилання й домени, що посилаються, одного target за періодами, з групуванням за group_range. Це похідна post_dataforseo_backlinks_timeseries_summary_live: той дає рівень, цей — зміну. Незмінний підсумок, що приховує сильну ротацію, видно лише тут. Ті самі цифри одразу для багатьох target дає post_dataforseo_backlinks_bulk_new_lost_backlinks_live. Тут немає параметра limit, тому єдиний спосіб зменшити витрати — викликати ендпоінт рідше.

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

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

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

Тіло

application/json

Тип: array (object | null)[]
- date_from
  Тип: string | null
  
  початкова дата часового діапазону
  необов'язкове поле
  це поле вказує дату, яка використовуватиметься як поріг для нових і втрачених зворотних посилань і доменів, що посилаються;
  зворотні посилання й домени, що посилаються, які з'явилися в нашому індексі після вказаної дати, вважаються новими;
  зворотні посилання й домени, що посилаються, не знайдені після вказаної дати, але присутні раніше, вважаються втраченими;
  
  мінімальне значення: 2019-01-30
  максимальне значення не повинно перевищувати дату, вказану в date_to
  формат дати: "yyyy-mm-dd"
  приклад:
  "2021-01-01"
- date_to
  Тип: string | null
  
  кінцева дата часового діапазону
  необов'язкове поле
  якщо не вказати це поле, за замовчуванням буде використано сьогоднішню дату
  мінімальне значення не повинно бути раніше дати, вказаної в date_from
  максимальне значення: сьогоднішня дата
  формат дати: "yyyy-mm-dd"
  приклад:
  "2021-01-15"
- group_range
  Тип: string | null
  
  часовий діапазон, який використовується для групування результатів
  необов'язкове поле
  значення за замовчуванням: month
  можливі значення: day, week, month, year
  
  примітка: для day ми повернемо елементи, що відповідають усім датам між date_from і date_to включно;
  для week/month/year ми повернемо елементи, що відповідають повним тижням/місяцям/рокам, причому кожен елемент указуватиме на останній день тижня/місяця/року
  
  наприклад, якщо вказати:
  "group_range": "month", "date_from": "2022-03-23", "date_to": "2022-05-13"
  ми повернемо елементи в проміжку з 2022-03-01 по 2022-05-31, а саме три елементи, що відповідають датам 2022-03-31, 2022-04-30, 2022-05-31
  
  якщо даних для певного day/week/month/year немає, ми повернемо 0
- include_subdomains
  Тип: boolean | null
  
  вказує, чи включаються піддомени target у пошук
  необов'язкове поле
  якщо встановлено false, піддомени ігноруються
  значення за замовчуванням: true
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді
- target
  Тип: string
  
  домен, для якого потрібно отримати дані
  обов'язкове поле
  домен вказується без https:// і www.
  приклад:
  "forbes.com"

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

масив результатів

date_from
Тип: string | null

дата початку часового діапазону
у форматі UTC: “yyyy-mm-dd”
приклад:
2019-01-01

date_to
Тип: string | null

дата закінчення часового діапазону
у форматі UTC: "yyyy-mm-dd"
приклад:
"2019-01-15"

group_range
Тип: string | null

group_range із POST-масиву

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

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

date
Тип: string | null

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

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

кількість втрачених зворотних посилань
кількість втрачених зворотних посилань target

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

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

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

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

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

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

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

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

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

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

type
Тип: string | null

тип елемента

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

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

target
Тип: string | null

target із POST-масиву

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
]'

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

{
  "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,
          "date_from": null,
          "date_to": null,
          "group_range": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "new_backlinks": null,
              "lost_backlinks": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "new_referring_main_domains": null,
              "lost_referring_main_domains": null
            }
          ]
        }
      ]
    }
  ]
}

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

Зведений часовий ряд нових і втрачених зворотних посилань

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

DataForSEO

Зведений часовий ряд нових і втрачених зворотних посилань

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