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

Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

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
            }
          ]
        }
      ]
    }
  ]
}

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

Нужна помощь?

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

Временной ряд обратных ссылок: сводка

АутентификацияRequired

DataForSEO

Временной ряд обратных ссылок: сводка

Справочные цены

Нужна помощь?