Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
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 Операції

Масова зведена інформація про сторінки

​

Показники зворотних посилань на рівні сторінок одразу для багатьох targets: один рядок на url із rank, main_domain_rank, backlinks, first_seen, lost_date, backlinks_spam_score і broken_backlinks. Версія для одного target — post_dataforseo_backlinks_domain_pages_summary_live. Тут немає параметра limit, тому єдиний спосіб зменшити витрати — викликати ендпоінт рідше.

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

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

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

Тіло
application/json
  • Тип: array (object | null)[]
    • 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 відповіді

    • targets
      Тип: array string[]

      домени, піддомени або вебсторінки, для яких потрібно отримати зведені дані
      обов'язкове поле
      домен або піддомен вказується без https:// і www.
      сторінка вказується абсолютним URL (включно з http:// або https://)
      у кожному запиті можна вказати до 1000 сторінок, доменів або піддоменів.
      URL в одному запиті не можуть належати більш ніж 100 різним доменам.

Відповіді
  • 200
    Тип: object | null · Response36Afe1097B20_BacklinksBulkPagesSummaryLiveResponseInfo
    • cost
      Тип: number | null Формат: double

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

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

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

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

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

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

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

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

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

            • 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

            • main_domain_rank
              Тип: integer | null

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

            • rank
              Тип: integer | null

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

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

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

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

              кількість доменів, що передають target щонайменше одне 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

              коди країн ISO вхідних посилань
              вказує коди країн ISO доменів, де розташовані вхідні посилання, і кількість посилань для кожної країни

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

                Signed 64-bit integers (long type).

            • referring_links_platform_types
              Тип: object | null

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

              можливі значення: cms, blogs, ecommerce, message-boards, wikis, news, organization

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

                Signed 64-bit integers (long type).

            • referring_links_semantic_locations
              Тип: object | null

              семантичні розташування вхідних посилань
              вказує семантичні елементи HTML, у яких розташовані вхідні посилання, і кількість посилань для кожного семантичного розташування

              Повний список семантичних елементів можна отримати тут
              приклади:
              article, section, footer

              • 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

              типи вхідних посилань
              вказує типи вхідних посилань і кількість посилань кожного типу
              можливі значення:
              anchor, image, link, meta, canonical, alternate, redirect

              • 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

              вказує кількість сторінок, що вказують на відповідний url

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

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

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

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

            • type
              Тип: string | null

              тип елемента

            • url
              Тип: string | null

              URL сторінки

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

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

          • 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
Request Example for post/v1/beta/dataforseo/backlinks/bulk_pages_summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_pages_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "https://dataforseo.com/solutions",
      "https://dataforseo.com/about-us"
    ]
  }
]'

{
  "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": [
        {
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "rank": null,
              "main_domain_rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

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

Bulk Pages Summary