API SimilarWeb Аудитория
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите оценочный профиль посетителей домена в SimilarWeb: распределение по полу, возрастные группы, другие сайты и темы, которые предпочитают посетители, технологии сайта и долю органического и платного поиска. Это агрегированные оценки с датой снимка. Они не идентифицируют людей и не являются собственными данными сайта.
SimilarWeb Audience получает профиль посетителей одного сайта по его домену в keyword: соотношение мужчин и женщин среди посетителей, распределение по возрасту, другие сайты, которыми пользуются посетители, темы и категории, которые им интереснее всего, технологии, на которых работает сайт, и доли органического и платного поискового трафика. Возможность отвечает на вопрос, кто посещает сайт, а не сколько у него посетителей. Маркетологи используют её, чтобы проверить, охватывает ли сайт их целевых клиентов, планировать рекламные размещения и партнёрства, а также оценить аудиторию конкурента.
Передайте домен сайта, например facebook.com. Цифры представляют собой оценки SimilarWeb, а не собственную аналитику сайта, и данные поступают с задержкой, поэтому смотрите на snapshot_date, прежде чем считать значение актуальным. Сравнение organic_traffic_share с paid_traffic_share показывает, привлекает ли сайт посетителей из поиска за счёт SEO или платной рекламы. Чтобы получить данные о числе посещений и рейтингах, вызовите SimilarWeb Search с тем же доменом.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra SimilarWeb Аудитория (similarweb/audience).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: similarweb и action: audience, а параметры передайте в params.
- Обязательные параметры:
- keyword: Целевой домен для анализа (например, example.com), а не общий поисковый запрос. В зависимости от действия возвращает обзор трафика в search, список похожих сайтов в competitors или профиль посетителей домена в audience.
- Возвращает один объект. Основные поля: id, url, name, male_share, female_share, age_distribution, top_interested_websites, top_interested_topics, top_interested_categories, technologies, organic_traffic_share, paid_traffic_share; всего полей: 13, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=similarweb.
- Пример тела запроса:
{
"platform": "similarweb",
"action": "audience",
"params": {
"keyword": "facebook.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 | Да | audience | Идентификатор возможности, фиксированное значение. |
keyword | body.params | string | Да | - | Целевой домен для анализа (например, example.com), а не общий поисковый запрос. В зависимости от действия возвращает обзор трафика в search, список похожих сайтов в competitors или профиль посетителей домена в audience. Метрики являются сторонними оценками и не отражают внутренние данные аналитики GA4. |
Примеры кода
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": "audience",
"params": {
"keyword": "facebook.com"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "similarweb",
"action": "audience",
"results": {
"id": "facebook.com",
"url": "https://facebook.com",
"name": "Facebook",
"male_share": 0,
"female_share": 0,
"age_distribution": [
{
"min_age": 25,
"max_age": 34,
"share": 0
},
{
"min_age": 35,
"max_age": 44,
"share": 0
},
{
"min_age": 45,
"max_age": 54,
"share": 0
}
],
"top_interested_websites": [
"instagram.com",
"google.com",
"youtube.com"
],
"top_interested_topics": [
"news",
"shopping",
"games"
],
"top_interested_categories": [
"games/video_games_consoles_and_accessories",
"adult",
"computers_electronics_and_technology/programming_and_developer_software"
],
"technologies": [
{
"category": "payment_and_currencies",
"top_tech": "Cart Functionality",
"tech_count": 33
},
{
"category": "advertising",
"top_tech": "Google Adsense",
"tech_count": 15
},
{
"category": "audio_video_media",
"top_tech": "YouTube",
"tech_count": 6
}
],
"organic_traffic_share": 0,
"paid_traffic_share": 0,
"snapshot_date": "2026-08-01T00:00:00+00:00",
"platform": "similarweb"
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
url | Ссылка на запись на платформе. |
name | Название самого объекта для возможностей по аккаунтам, товарам и компаниям. |
male_share | Трактуется так же, как на самой платформе |
female_share | Трактуется так же, как на самой платформе |
age_distribution | Трактуется так же, как на самой платформе |
top_interested_websites | Трактуется так же, как на самой платформе |
top_interested_topics | Трактуется так же, как на самой платформе |
top_interested_categories | Трактуется так же, как на самой платформе |
technologies | Трактуется так же, как на самой платформе |
organic_traffic_share | Трактуется так же, как на самой платформе |
paid_traffic_share | Трактуется так же, как на самой платформе |
snapshot_date | Трактуется так же, как на самой платформе |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
FAQ
Чем это отличается от SimilarWeb Search?
SimilarWeb Search описывает трафик сайта: рейтинг, расчётное число посещений, вовлечённость и источники визитов. Audience описывает профиль посетителей: соотношение мужчин и женщин, возраст, интересы и другие сайты, которыми они пользуются, а также технологии сайта и соотношение органического и платного поискового трафика. Обе возможности принимают один и тот же домен в keyword.
Что здесь означают метки категорий вроде computers_electronics_and_technology?
Это собственные названия категорий SimilarWeb. В top_interested_categories они обозначают категории контента, которые больше всего интересуют посетителей сайта, а это не то же самое, что категория самого сайта; её возвращает SimilarWeb Search. Метки не сопоставляются с категориями других платформ.
male_share и female_share — это измеренные значения?
Нет. Как и другие показатели, это оценки SimilarWeb, а не данные собственной аналитики сайта. Используйте их, чтобы сравнивать сайты между собой, рассматривайте их вместе с age_distribution и храните snapshot_date с каждым сохранённым значением.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.