API G2 Сравнение товаров

Q: Как указать продукты для сравнения?

Передайте их в slugs массивом строк, по одной на продукт: слаг продукта на G2 (часть ссылки на G2 после /products/) или полный URL продукта. Слаги объединяются через -vs-, образуя адрес страницы сравнения. Ссылки на продукты, из которых можно взять слаги, возвращает G2 Search.

Q: Что имеет приоритет, если передать несколько входных параметров?

Приоритет имеет полный url страницы сравнения, затем combined_slug, то есть часть адреса после /compare/, и только потом slugs. Чтобы запрос был однозначным, передавайте только один из этих параметров. Если вы скопировали адрес страницы сравнения из браузера, передайте его целиком в url и не указывайте slugs.

Q: Что содержит ratings?

ratings содержит детализацию оценок по критериям со страницы сравнения. Так вы видите, в чём продукты различаются, и не полагаетесь на одну общую оценку. Смотрите это поле вместе с alternatives_shown, где перечислены альтернативные продукты, которые страница предлагает помимо указанных вами. У каждого из них есть слаг, который можно передать в G2 Reviews.

Временно недоступна

Мы восстанавливаем эту возможность. До тех пор вызовы обычно завершаются ошибкой или не возвращают результатов; неудачные вызовы и пустые результаты не оплачиваются.

POST

Состояние API

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

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

Норма

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

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

Сравнивайте продукты G2, указанные в slugs, на одной странице сравнения. Получайте рейтинг и число отзывов каждого продукта, оценки по параметрам и альтернативы, которые предлагает страница. Слаги объединяются через -vs- в путь страницы. Можно также передать готовый combined_slug.

Возможность G2 Product comparison считывает данные одной страницы сравнения G2, на которой программные продукты показаны рядом. Она возвращает url страницы, её combined_slug, записи о продуктах в products и их количество в product_count, детализацию оценок по критериям в ratings, а также предлагаемые страницей альтернативные продукты в alternatives_shown. Для каждого альтернативного продукта указаны слаг, название и ссылка. Покупатели ПО с её помощью видят, чем продукты отличаются по каждому критерию, а продакт-маркетологи отслеживают, как их продукт оценивается в сравнении с конкретными конкурентами.

Укажите продукты в slugs или передайте уже известную страницу сравнения через combined_slug или url. Возвращаемый combined_slug содержит объединённый слаг сравнения, то есть часть адреса после /compare/. Сохраняйте его вместе с датой каждого вызова, чтобы сопоставлять последующие данные той же страницы с предыдущими.

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

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra G2 Сравнение товаров (g2/compare).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: g2 и action: compare, а параметры передайте в params.
- Обязательные параметры:
  - slugs: Массив слагов или URL продуктов для действия compare; они автоматически объединяются через -vs- в путь сравнения G2. Параметр не выполняет отдельные параллельные запросы и не принимает названия вендоров.
- Необязательные параметры:
  - combined_slug: Готовый объединённый слаг пути сравнения после /compare/ для действия compare; имеет приоритет над автоматически сформированными массивами слагов. Не принимает одиночные идентификаторы вендора или продукта.
  - url: URL целевого ресурса G2 или слаг. Для profile, reviews и alternatives передайте URL /products/<slug> или слаг продукта; для vendor передайте URL /sellers/<slug> или слаг продавца.
- Возвращает один объект. Основные поля: url, combined_slug, product_count, products, ratings, alternatives_shown.
- Пример тела запроса:
{
  "platform": "g2",
  "action": "compare",
  "params": {
    "slugs": [
      "slack",
      "microsoft-teams"
    ]
  }
}
- Цена: $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`	Да	`g2`	Идентификатор платформы, фиксированное значение.
`action`	body	`string`	Да	`compare`	Идентификатор возможности, фиксированное значение.
`slugs`	body.params	`array`	Да	-	Массив слагов или URL продуктов для действия compare; они автоматически объединяются через -vs- в путь сравнения G2. Параметр не выполняет отдельные параллельные запросы и не принимает названия вендоров; выбирайте сочетания продуктов, для которых на G2 есть страницы сравнения.
`combined_slug`	body.params	`string`	Нет	-	Готовый объединённый слаг пути сравнения после /compare/ для действия compare; имеет приоритет над автоматически сформированными массивами слагов. Не принимает одиночные идентификаторы вендора или продукта; явно переданный параметр url имеет ещё более высокий приоритет.
`url`	body.params	`string`	Нет	-	URL целевого ресурса G2 или слаг. Для profile, reviews и alternatives передайте URL /products/<slug> или слаг продукта; для vendor передайте URL /sellers/<slug> или слаг продавца. Для compare полный URL /compare/ переопределяет автоматически сформированный путь, но обязательный параметр slugs всё равно нужно передать.

Примеры кода

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": "g2",
  "action": "compare",
  "params": {
    "slugs": [
      "slack",
      "microsoft-teams"
    ]
  }
}'

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

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

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json

{
  "id": "req_…",
  "platform": "g2",
  "action": "compare",
  "results": {
    "url": …,
    "combined_slug": …,
    "product_count": …,
    "products": …,
    "ratings": …,
    "alternatives_shown": …,
    "platform": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

Поле	Значение
`url`	Ссылка на запись на платформе.
`combined_slug`	Трактуется так же, как на самой платформе
`product_count`	Трактуется так же, как на самой платформе
`products`	Трактуется так же, как на самой платформе
`ratings`	Трактуется так же, как на самой платформе
`alternatives_shown`	Трактуется так же, как на самой платформе
`platform`	Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Как указать продукты для сравнения?

Передайте их в slugs массивом строк, по одной на продукт: слаг продукта на G2 (часть ссылки на G2 после /products/) или полный URL продукта. Слаги объединяются через -vs-, образуя адрес страницы сравнения. Ссылки на продукты, из которых можно взять слаги, возвращает G2 Search.

Что имеет приоритет, если передать несколько входных параметров?

Приоритет имеет полный url страницы сравнения, затем combined_slug, то есть часть адреса после /compare/, и только потом slugs. Чтобы запрос был однозначным, передавайте только один из этих параметров. Если вы скопировали адрес страницы сравнения из браузера, передайте его целиком в url и не указывайте slugs.

Что содержит `ratings`?

ratings содержит детализацию оценок по критериям со страницы сравнения. Так вы видите, в чём продукты различаются, и не полагаетесь на одну общую оценку. Смотрите это поле вместе с alternatives_shown, где перечислены альтернативные продукты, которые страница предлагает помимо указанных вами. У каждого из них есть слаг, который можно передать в G2 Reviews.

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

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

Ошибки