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

Часовий ряд зворотних посилань: зведення

Ключові показники зворотних посилань одного target у часі, з групуванням за group_range (день, тиждень, місяць). Повертає date_from, date_to, group_range і один елемент на період. Для приросту й втрат, а не підсумків, використовуйте post_dataforseo_backlinks_timeseries_new_lost_live. Тут немає параметра limit, тому єдиний спосіб зменшити витрати — викликати ендпоінт рідше.

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

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.0273.
Довідковий множник для клієнта: 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
- 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_BacklinksTimeseriesSummaryLiveResponseInfo
cost
Тип: number | null Формат: double

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

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

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

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

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

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

date
Тип: string | null

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

rank
Тип: integer | null

ранг target на вказану date
Докладніше про метрику та спосіб її розрахунку — у цій статті довідкового центру

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_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,
              "rank": null,
              "backlinks": null,
              "backlinks_nofollow": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null
            }
          ]
        }
      ]
    }
  ]
}

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

Часовий ряд зворотних посилань: зведення

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

DataForSEO

Часовий ряд зворотних посилань: зведення

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