Felo API PlatformFelo API Platform
Все эндпоинты DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Домены по технологии

Сервер:https://openapi.felo.ai
Клиентские библиотеки

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Домены по технологии

​

Находит домены, использующие заданную технологию, — обратная операция к post_dataforseo_domains_tech_for_domain_live. Принимает technologies, technology_paths, groups, categories и keywords, а также filters и order_by по полям, указанным в get_dataforseo_domains_tech_available_filters. Возвращает total_count, items_count, offset, offset_token и items, каждый элемент — тот же профиль, что и в вызове по домену: domain, title, description, meta_keywords, domain_rank, last_visited, country_iso_code, language_code, content_language_code, phone_numbers, emails, social_graph_urls и technologies.

Справочная информация о ценах

  • Тарификация: заявленная стоимость ответа.
  • Справочная оценка запроса: USD 0.012.
  • Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Тело
application/json
  • Тип: array (object | null)[]
    • categories
      Тип: array string[]

      идентификаторы целевых категорий технологий
      обязательное поле, если не указаны groups, technology_paths, keywords или technologies
      полный список идентификаторов категорий технологий можно найти на этой странице
      примечание: в этом массиве можно указать до 10 категорий технологий
      пример:
      ["payment_processors","crm"]

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

      массив параметров фильтрации результатов
      необязательное поле
      можно добавить несколько фильтров одновременно (не более 8)
      между условиями нужно указать логический оператор and или or
      поддерживаются следующие операторы:
      <, <=, >, >=, =, <>, in, not_in, like, not_like
      оператор % можно использовать с like и not_like для сопоставления любой строки из нуля или более символов
      пример:
      ["country_iso_code","=","US"]

      [["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

      Пустой объект
    • groups
      Тип: array string[]

      идентификаторы целевых групп технологий
      обязательное поле, если не указаны technologies, technology_paths, keywords или categories
      полный список идентификаторов групп технологий можно найти на этой странице
      примечание: в этом массиве можно указать до 10 групп технологий
      пример:
      ["sales", "marketing"]

    • keywords
      Тип: array string[]

      целевые ключевые слова в заголовке, описании или мета-ключевых словах домена
      обязательное поле, если не указаны groups, technology_paths, technologies или categories
      необязательное поле
      можно указать максимум 10 ключевых слов;
      кодировка UTF-8;
      пример:
      ["seo","software"]

      Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в статье Help Center

    • limit
      Тип: integer | null

      максимальное количество возвращаемых доменов
      необязательное поле
      значение по умолчанию: 100
      максимальное значение: 10000

    • mode
      Тип: string | null

      режим поиска
      необязательное поле
      возможные типы режима поиска:
      as_is - поиск результатов, точно соответствующих указанным идентификаторам групп, идентификаторам категорий или названиям технологий
      entry - поиск результатов, соответствующих части указанных идентификаторов групп, идентификаторов категорий или названий технологий
      значение по умолчанию: as_is

    • 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"]

    • technologies
      Тип: array string[]

      целевые технологии
      обязательное поле, если не указаны groups, technology_paths, keywords или categories
      полный список технологий, которые можно указать, приведён на этой странице
      примечание: в этом массиве можно указать до 10 технологий
      пример:
      ["Google Pay","Salesforce"]

    • technology_paths
      Тип: array string[]

      целевые пути технологий
      обязательное поле, если не указаны groups, technologies, keywords или categories
      необходимо задать хотя бы одно поле (technology_paths, groups, technologies, keywords или categories);
      каждый путь технологии указывается отдельным объектом с полями "path" и "name", где "path" задаётся как "$group_id.$category_id", а "name" — как название целевой технологии;
      каждый объект с путём технологии разделяется запятой
      полный список идентификаторов групп технологий, идентификаторов категорий и названий технологий можно найти на этой странице
      примечание: в этом массиве можно указать до 10 путей технологий
      пример:
      [{"path": "content.cms","name": "wordpress"}, {"path": "marketing.crm","name": "salesforce"}]

Ответы
  • 200
    Тип: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByTechnologyLiveResponseInfo
    • cost
      Тип: number | null Формат: double

      общая стоимость задач, USD

    • status_code
      Тип: integer | null

      общий код состояния. Полный список кодов ответа можно найти здесь.

    • status_message
      Тип: string | null

      общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.

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

      массив задач

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

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

    application/json
Request Example for post/v1/beta/dataforseo/domain_analytics/technologies/domains_by_technology/live
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/domains_by_technology/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "technologies": [
      "Nginx"
    ],
    "filters": [
      [
        "country_iso_code",
        "=",
        "US"
      ],
      "and",
      [
        "domain_rank",
        ">",
        800
      ]
    ],
    "order_by": [
      "last_visited,desc"
    ],
    "limit": 10
  }
]'
{
  "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]"
            }
          ]
        }
      ]
    }
  ]
}
Domains by Technology

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