v0.2.0-beta

OpenAPI 3.1.0

Домени за HTML-термінами

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/domain_analytics/technologies/domains_by_html_terms/live

Домени за HTML-термінами

Знаходить домени, HTML яких містить задані search_terms, — необроблений збіг рядка, тоді як post_dataforseo_domains_tech_domains_by_technology_live зіставляє виявлену технологію. Використовуйте для трекінг-сніпета, партнерського тегу або підпису шаблону, які не називає жоден детектор. Повертає total_count, items_count, offset, offset_token і items з тим самим профілем, що й пошук за технологіями.

Довідкова інформація про ціни

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

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

Тіло

application/json

Тип: array (object | null)[]
- filters
  Тип: array (object | null)[] | null
  
  масив параметрів фільтрації результатів
  необов'язкове поле
  можна додати кілька фільтрів одночасно (не більше 8)
  між умовами потрібно вказати логічний оператор and або or
  підтримуються такі оператори:
  <, <=, >, >=, =, <>, in, not_in, like, not_like
  оператор % можна використовувати з like і not_like для зіставлення будь-якого рядка з нуля або більше символів
  приклад:
  ["domain","like","%seo%"]
  
  [["country_iso_code","=","US"], "and", ["domain_rank",">",100]]
  
  [["domain_rank",">",100], "and", [["country_iso_code","=","US"],"or",["country_iso_code","=","CA"]]]
  
  докладніше про фільтри див. в Domain Analytics Technologies API - Filters
  
  Порожній об'єкт
- keywords
  Тип: array string[] | null
  
  цільові ключові слова в заголовку, описі або мета-ключових словах домену
  необов'язкове поле
  кодування UTF-8
  максимальна кількість ключових слів: 10
  приклад:
  ["seo","software"]
  
  Докладніше про правила й обмеження полів keyword і keywords в API DataForSEO читайте в статті Help Center
- limit
  Тип: integer | null
  
  максимальна кількість доменів, що повертаються
  необов'язкове поле
  значення за замовчуванням: 100
  максимальне значення: 10000
- mode
  Тип: string | null
  
  режим пошуку
  необов'язкове поле
  можливі типи режиму пошуку:
  strict_entry — пошук результатів, що точно відповідають порядку, інтервалам і роздільникам у вказаних пошукових запитах
  entry — пошук результатів без урахування порядку, інтервалів і роздільників у вказаних пошукових запитах
  значення за замовчуванням: entry
- offset
  Тип: integer | null
  
  зміщення в масиві результатів доменів, що повертаються
  необов'язкове поле
  значення за замовчуванням: 0
  якщо вказати значення 10, перші десять доменів у масиві результатів буде пропущено, а дані буде надано для наступних доменів;
  Примітка: максимальне значення — 9999, сума limit і offset не може перевищувати 10000;
  якщо потрібно змістити більше результатів, використовуйте offset_token
- offset_token
  Тип: string | null
  
  токен для наступних запитів
  необов'язкове поле
  надається в тому самому полі відповіді на кожен запит;
  використовуйте цей параметр, щоб уникнути тайм-аутів під час спроби отримати понад 100 000 результатів в одному запиті;
  вказавши унікальне значення offset_token з масиву відповіді, ви отримаєте наступні результати початкового завдання;
  значення offset_token унікальні для кожного наступного завдання
  Примітка: якщо в запиті вказано offset_token, усі інші параметри мають бути ідентичні попередньому запиту
  Докладніше про цей параметр у нашому Help Center
- order_by
  Тип: array string[] | null
  
  правила сортування результатів
  необов'язкове поле
  доступні поля:
  domain_rank, domain, last_visited, country_iso_code, language_code, content_language_code
  можливі типи сортування:
  asc — результати сортуються за зростанням
  desc — результати сортуються за спаданням
  тип сортування задається через кому
  приклад:
  ["last_visited,desc"]
  правило за замовчуванням:
  ["domain_rank,desc"]
  зауважте: в одному запиті можна задати не більше трьох правил сортування
  кілька правил сортування розділяються комою
  приклад:
  ["last_visited,desc","domain_rank,desc"]
- search_terms
  Тип: array string[]
  
  цільові пошукові запити
  обов'язкове поле
  вкажіть цільові HTML-елементи, теги, атрибути, їхній вміст або все перелічене
  якщо вказати більше одного пошукового запиту, буде повернуто лише домени, в HTML-коді головної сторінки яких містяться всі вказані запити
  максимальна кількість пошукових запитів: 10
  приклад:
  ["data-attrid"]

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

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

масив items

content_language_code
Тип: string | null

мова вмісту
код мови, якою написано вміст на цільовому домені

country_iso_code
Тип: string | null

ISO-код домену
ISO-код країни, до якої віднесено цільовий домен

description
Тип: string | null

метаопис домену

domain
Тип: string | null

вказане ім'я домену

domain_rank
Тип: integer | null

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

emails
Тип: array (string | null)[] | null

email цільового об'єкта
email, вказані на цільовому сайті

language_code
Тип: string | null

мова домену
код мови, з якою, як визначено, пов'язаний цільовий домен

last_visited
Тип: string | null

остання дата відвідування домену нашим краулером
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2022-10-10 12:57:46 +00:00

meta_keywords
Тип: array (string | null)[] | null

метаключові слова домену

phone_numbers
Тип: array (string | null)[] | null

номери телефонів цільового об'єкта
контактні номери телефонів, вказані на цільовому сайті

social_graph_urls
Тип: array (string | null)[] | null

посилання та акаунти в соцмережах
URL соціальних мереж, виявлені в соціальних графах цільового сайту

technologies
Тип: object | null · Response36Afe1097B20_TechnologiesInfo

технології, які використовує цільовий домен
містить об'єкти з назвами технологій, які використовуються на сайті;
повний список технологій та їхню структуру див. в ендпоінті технологій

add_ons
Тип: object | null
propertyName
Тип: array (string | null)[] | null
analytics
Тип: object | null
propertyName
Тип: array (string | null)[] | null
booking
Тип: object | null
propertyName
Тип: array (string | null)[] | null
business_tools
Тип: object | null
propertyName
Тип: array (string | null)[] | null
communication
Тип: object | null
propertyName
Тип: array (string | null)[] | null
content
Тип: object | null
propertyName
Тип: array (string | null)[] | null
location
Тип: object | null
propertyName
Тип: array (string | null)[] | null
marketing
Тип: object | null
propertyName
Тип: array (string | null)[] | null
media
Тип: object | null
propertyName
Тип: array (string | null)[] | null
other
Тип: object | null
propertyName
Тип: array (string | null)[] | null
privacy
Тип: object | null
propertyName
Тип: array (string | null)[] | null
sales
Тип: object | null
propertyName
Тип: array (string | null)[] | null
security
Тип: object | null
propertyName
Тип: array (string | null)[] | null
servers
Тип: object | null
propertyName
Тип: array (string | null)[] | null
user_generated_content
Тип: object | null
propertyName
Тип: array (string | null)[] | null
utilities
Тип: object | null
propertyName
Тип: array (string | null)[] | null
web_development
Тип: object | null
propertyName
Тип: array (string | null)[] | null
title
Тип: string | null

метазаголовок домену

type
Тип: string | null

тип елемента

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

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

offset
Тип: integer | null

вказане значення зміщення

offset_token
Тип: string | null

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

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/domain_analytics/technologies/domains_by_html_terms/live

curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/domains_by_html_terms/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "search_terms": [
      "data-attrid"
    ],
    "order_by": [
      "last_visited,desc"
    ],
    "limit": 10,
    "offset": 0
  }
]'

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

{
  "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,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "type": null,
              "domain": null,
              "title": null,
              "description": null,
              "meta_keywords": [
                "[Max Depth Exceeded]"
              ],
              "domain_rank": null,
              "last_visited": null,
              "country_iso_code": null,
              "language_code": null,
              "content_language_code": null,
              "phone_numbers": [
                "[Max Depth Exceeded]"
              ],
              "emails": [
                "[Max Depth Exceeded]"
              ],
              "social_graph_urls": [
                "[Max Depth Exceeded]"
              ],
              "technologies": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

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

Домени за HTML-термінами

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

DataForSEO

Домени за HTML-термінами

Довідкова інформація про ціни