API SimilarWeb Поиск

Q: Что означают значения категорий вроде computers_electronics_and_technology?

category — категория сайта в собственной классификации SimilarWeb, поэтому значение вроде computers_electronics_and_technology является меткой SimilarWeb, а не универсальным кодом для разных платформ. category_rank — место сайта по трафику внутри этой категории, поэтому для нишевых сайтов этот показатель лучше подходит для сравнения, чем global_rank.

Q: Насколько актуальны данные о трафике?

Смотрите на snapshot_date: это дата снимка, из которого взяты цифры. Данные о трафике поступают с задержкой, поэтому не воспринимайте monthly_visits как текущий счётчик за этот месяц. Если вы отслеживаете сайт во времени, сохраняйте каждый результат вместе с его snapshot_date и сравнивайте снимки, а не даты вызовов.

POST

Состояние API

Состояние за 24 ч: Норма
Среднее время за 24 ч: —

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Норма

Последние 24 часа

Последние 30 дней

Получите обзор трафика одного домена в SimilarWeb: позиции в мировом рейтинге, рейтинге по стране и категории, оценочное число посещений за месяц, показатель отказов, источники трафика и основные страны. Передайте домен вида example.com, а не поисковый запрос. Цифры являются модельными оценками с датой снимка, а не собственной аналитикой сайта.

SimilarWeb Search получает сводку по трафику одного сайта по его домену в keyword: глобальный рейтинг, рейтинг в стране и в категории, оценку ежемесячных посещений, показатель отказов, число страниц за посещение, среднюю продолжительность посещения, страны, поисковые запросы, ссылающиеся сайты и социальные сети, откуда приходит трафик, структуру источников трафика, конкурентов, которых указывает SimilarWeb, и основные сведения о компании, которой принадлежит сайт. Маркетологи, инвесторы и отделы продаж используют эту возможность, чтобы оценить сайт, сравнить его с конкурентами и понять, откуда приходят его посетители.

Несмотря на название, возможность не ищет в интернете по запросу: передайте домен, например example.com. Эти показатели представляют собой модельные оценки SimilarWeb, а не данные собственной аналитики сайта, поэтому сравнивайте сайты между собой, а не со своими данными. Чем меньше номер в рейтинге, тем лучше. bounce_rate указан долей: 0.6 означает 60 %, а avg_visit_duration указан в секундах.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra SimilarWeb Поиск (similarweb/search).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: similarweb и action: search, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Целевой домен для анализа (например, example.com), а не общий поисковый запрос. В зависимости от действия возвращает обзор трафика в search, список похожих сайтов в competitors или профиль посетителей домена в audience.
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.
- Возвращает список записей. Основные поля каждой записи: id, url, name, text, category, global_rank (Место по трафику в мире), country_rank (Место по трафику в своей стране), category_rank (Место по трафику в своей категории), country, monthly_visits, bounce_rate, pages_per_visit; всего полей: 29, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=similarweb.
- Пример тела запроса:
{
  "platform": "similarweb",
  "action": "search",
  "params": {
    "keyword": "example.com"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`platform`	body	`string`	Да	`similarweb`	Идентификатор платформы, фиксированное значение.
`action`	body	`string`	Да	`search`	Идентификатор возможности, фиксированное значение.
`keyword`	body.params	`string`	Да	-	Целевой домен для анализа (например, example.com), а не общий поисковый запрос. В зависимости от действия возвращает обзор трафика в search, список похожих сайтов в competitors или профиль посетителей домена в audience. Метрики являются сторонними оценками и не отражают внутренние данные аналитики GA4.
`limit`	body.params	`integer (1–)`	Нет	-	Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.

Примеры кода

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "similarweb",
  "action": "search",
  "params": {
    "keyword": "example.com"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json

{
  "id": "req_…",
  "platform": "similarweb",
  "action": "search",
  "results": [
    {
      "id": "example.com",
      "url": "https://www.similarweb.com/website/example.com",
      "name": "example.com",
      "text": "",
      "category": "computers_electronics_and_technology/programming_and_developer_software",
      "global_rank": 7941,
      "country_rank": 12471,
      "category_rank": 280,
      "monthly_visits": 9345666,
      "bounce_rate": 0.6514912791710534,
      "avg_visit_duration": "00:02:30",
      "top_countries": [
        {
          "countryAlpha2Code": "US",
          "countryAlpha2CodeRaw": "US",
          "countryUrlCode": "united-states",
          "visitsShare": 0.1329426107445016,
          "visitsShareChange": 0.23721803817648812
        },
        {
          "countryAlpha2Code": "GB",
          "countryAlpha2CodeRaw": "GB",
          "countryUrlCode": "united-kingdom",
          "visitsShare": 0.09609787381537664,
          "visitsShareChange": 0.748813150577166
        },
        {
          "countryAlpha2Code": "IN",
          "countryAlpha2CodeRaw": "IN",
          "countryUrlCode": "india",
          "visitsShare": 0.0812021419465102,
          "visitsShareChange": 0.2577621588969865
        }
      ],
      "top_keywords": [
        {
          "name": "www.example.com",
          "estimatedValue": null,
          "volume": null,
          "cpc": null
        },
        {
          "name": "example.com",
          "estimatedValue": null,
          "volume": null,
          "cpc": 0.71
        },
        {
          "name": "price comparison",
          "estimatedValue": null,
          "volume": null,
          "cpc": 1.64
        }
      ],
      "traffic_sources": [
        {
          "source": "ads",
          "rank": 1,
          "percentage": 0.464616847938312,
          "isHigher": null
        },
        {
          "source": "direct",
          "rank": 2,
          "percentage": null,
          "isHigher": null
        },
        {
          "source": "referrals",
          "rank": 3,
          "percentage": null,
          "isHigher": null
        }
      ],
      "top_referrals": [
        {
          "domain": "",
          "icon": "",
          "visitsShare": 0.23747686624030057,
          "isLocked": true,
          "isAvailable": true
        },
        {
          "domain": "",
          "icon": "",
          "visitsShare": 0.04233750061365961,
          "isLocked": true,
          "isAvailable": true
        },
        {
          "domain": "",
          "icon": "",
          "visitsShare": 0.03883400072797977,
          "isLocked": true,
          "isAvailable": true
        }
      ],
      "social_distribution": [
        {
          "name": "Reddit",
          "visitsShare": 0.3005705760443808,
          "icon": "https://site-images.similarcdn.com/image?url=reddit.com&t=2&s=1&h=66f2412047e0362ec60d5583d4b186511a8e859446bb112c60d22968facae906"
        },
        {
          "name": "Youtube",
          "visitsShare": 0.1996099164167749,
          "icon": "https://site-images.similarcdn.com/image?url=youtube.com&t=2&s=1&h=e117fb09ba0a34dee9830863bf927d29fc864e342583a36a667bf12346e88e20"
        },
        {
          "name": "Pinterest",
          "visitsShare": 0.12311561331673827,
          "icon": "https://site-images.similarcdn.com/image?url=pinterest.com&t=2&s=1&h=ec976160ca16242c6ab9ed7bc48e7b0f04c4100ceac5bcb6d3ea55450aa12210"
        }
      ],
      "competitors": [
        "simplilearn.com",
        "pennfoster.edu",
        "mygreatlearning.com"
      ],
      "snapshot_date": "2026-08-01T00:00:00+00:00",
      "platform": "similarweb"
    }
  ],
  "count": 1,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

Поле	Значение
`id`	Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
`url`	Ссылка на запись на платформе.
`name`	Название самого объекта для возможностей по аккаунтам, товарам и компаниям.
`text`	Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
`category`	Название категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
`global_rank`	Место по трафику в мире; чем меньше число, тем выше позиция.
`country_rank`	Место по трафику в своей стране.
`category_rank`	Место по трафику в своей категории.
`country`	Страна или регион: полное название либо код ISO в зависимости от платформы. Значение передаётся без нормализации.
`monthly_visits`	Трактуется так же, как на самой платформе
`bounce_rate`	Трактуется так же, как на самой платформе
`pages_per_visit`	Трактуется так же, как на самой платформе
`avg_visit_duration`	Трактуется так же, как на самой платформе
`company_name`	Трактуется так же, как на самой платформе
`company_founded`	Трактуется так же, как на самой платформе
`company_employees_min`	Трактуется так же, как на самой платформе
`company_employees_max`	Трактуется так же, как на самой платформе
`company_hq_country`	Трактуется так же, как на самой платформе
`company_hq_city`	Трактуется так же, как на самой платформе
`top_countries`	Трактуется так же, как на самой платформе
`top_keywords`	Трактуется так же, как на самой платформе
`traffic_sources`	Трактуется так же, как на самой платформе
`top_referrals`	Трактуется так же, как на самой платформе
`social_distribution`	Трактуется так же, как на самой платформе
`competitors`	Трактуется так же, как на самой платформе
`snapshot_date`	Трактуется так же, как на самой платформе
`email`	Контактный адрес электронной почты передаётся как есть.
`emails`	Контактные адреса электронной почты (у записи их может быть несколько) передаются как есть, без дубликатов.
`phone`	Контактный номер телефона передаётся без нормализации формата.
`platform`	Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Почему в `keyword` передаётся домен?

Потому что эта возможность анализирует один сайт, а не ищет в интернете. Передайте домен сайта, например example.com. Те же входные данные подходят для возможностей SimilarWeb Competitors и Audience, которые возвращают похожие сайты и профиль посетителей этого сайта, поэтому один список доменов можно использовать для всех трёх.

Что означают значения категорий вроде computers_electronics_and_technology?

category — категория сайта в собственной классификации SimilarWeb, поэтому значение вроде computers_electronics_and_technology является меткой SimilarWeb, а не универсальным кодом для разных платформ. category_rank — место сайта по трафику внутри этой категории, поэтому для нишевых сайтов этот показатель лучше подходит для сравнения, чем global_rank.

Насколько актуальны данные о трафике?

Смотрите на snapshot_date: это дата снимка, из которого взяты цифры. Данные о трафике поступают с задержкой, поэтому не воспринимайте monthly_visits как текущий счётчик за этот месяц. Если вы отслеживаете сайт во времени, сохраняйте каждый результат вместе с его snapshot_date и сравнивайте снимки, а не даты вызовов.

Ошибки и оплата

401: Ключ отсутствует или недействителен.
402: Недостаточно средств на балансе. Сначала пополните баланс.
422: Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429: Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503: Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто): Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

Similarweb: визиты, уникальные посетители и метрики вовлечённости ↗
Similarweb отличает ежемесячные визиты (Monthly Visits) от ежемесячных уникальных посетителей (Monthly Unique Visitors) и отдельно отслеживает длительность визита, число страниц за визит и показатель отказов. Это действие не принимает параметры фильтрации по дате, устройству и поддомену, а monthly_visits нельзя использовать как замену числа уникальных посетителей.
Проверено 2026-09-04