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

Конкуренти

Сайти, що поділяють домени, які посилаються, з одним target, відсортовані за кількістю спільних доменів. Кожен рядок містить target, rank і intersections — кількість спільних доменів, що посилаються. main_domain, exclude_large_domains і exclude_internal_backlinks визначають, що враховується. Це конкуренти за графом посилань, а не пошукові конкуренти; для останніх використовуйте post_dataforseo_labs_google_serp_competitors_live. Щоб побачити самі спільні домени, використовуйте post_dataforseo_backlinks_domain_intersection_live.

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

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

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

Тіло

application/json

Тип: array (object | null)[]
- exclude_internal_backlinks
  Тип: boolean | null
  
  вказує, чи виключаються з результатів внутрішні зворотні посилання з піддоменів на target
  необов'язкове поле
  якщо встановлено true, результати не міститимуть даних про внутрішні зворотні посилання з піддоменів того самого домену, що й target
  якщо встановлено false, внутрішні посилання буде включено до результатів
  значення за замовчуванням: true
- exclude_large_domains
  Тип: boolean | null
  
  вказує, чи з'являтимуться великі домени в результатах
  необов'язкове поле
  якщо встановлено true, результати з великого домену (google.com, amazon.com тощо) буде виключено;
  значення за замовчуванням: true
- filters
  Тип: array (object | null)[] | null
  
  масив параметрів фільтрації результатів
  необов'язкове поле
  можна додати кілька фільтрів одразу (не більше 8)
  між умовами потрібно вказати логічний оператор and або or
  підтримуються такі оператори:
  regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  оператор % можна використовувати з like і not_like, щоб зіставити будь-який рядок із нуля або більше символів
  приклад:
  ["rank",">","100"]
  
  [["target","like","%forbes%"], "and", [["rank",">","100"],"or",["intersections",">","5"]]]
  
  Повний список можливих фільтрів доступний тут.
  
  Порожній об'єкт
- limit
  Тип: integer | null
  
  максимальна кількість доменів, що повертаються
  необов'язкове поле
  значення за замовчуванням: 100
  максимальне значення: 1000
- main_domain
  Тип: boolean | null
  
  вказує, чи включатиметься в пошук лише основний домен target
  необов'язкове поле
  якщо встановлено true, до пошуку буде включено лише основний домен;
  значення за замовчуванням: true
- offset
  Тип: integer | null
  
  зміщення в масиві результатів доменів, що повертаються
  необов'язкове поле
  значення за замовчуванням: 0
  якщо вказати значення 10, перші десять доменів у масиві результатів буде пропущено, а дані буде надано для наступних сторінок
- order_by
  Тип: array string[] | null
  
  правила сортування результатів
  необов'язкове поле
  для сортування результатів можна використовувати ті самі значення, що й у масиві filters
  можливі типи сортування:
  asc — результати сортуються за зростанням
  desc — результати сортуються за спаданням
  тип сортування вказується через кому
  приклад:
  ["rank,desc"]
  в одному запиті можна задати не більше трьох правил сортування
  кілька правил сортування розділяються комою
  приклад:
  ["intersections,desc","rank,asc"]
- 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.
  сторінка вказується абсолютним URL (включно з http:// або https://)

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

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

intersections
Тип: integer | null

вказує кількість перетинів зворотних посилань із target, вказаним у POST-масиві

rank
Тип: integer | null

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

target
Тип: string | null

домен конкурента

type
Тип: string | null

тип елемента

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

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

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

post/v1/beta/dataforseo/backlinks/competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "filters": [
      "rank",
      ">",
      100
    ],
    "order_by": [
      "rank,desc"
    ],
    "limit": 5
  }
]'

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

{
  "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,
              "target": null,
              "rank": null,
              "intersections": null
            }
          ]
        }
      ]
    }
  ]
}

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

Конкуренти

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

DataForSEO

Конкуренти

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