SteveSignalsDocs

イベントリファレンス

レビューイベント

G2、Trustpilot、Capterra、Boxil のレビューの Webhook イベント。すべてのキーとその型、実例を紹介します。

レビューイベントは、トラッキング中の競合がレビューサイトで新しいレビューを受け取ったとき、またはレビューの本文や評価が変更されたときに発生します。1 件のレビューが 1 つのイベントです。

eventType
reviews
subEventType
g2_review · trustpilot_review · capterra_review · trustpilot_de_review · capterra_de_review · boxil_review
signalType
新しいレビューは reviews.new、本文や評価が変更されたレビューは reviews.updated です。reviews.removed はスキーマにありますが、送信されることはありません。
プラットフォームフィールド
reviewResponse(metadata と同じ値)
トラッカー
レビュー
relevance
常に { "status": "unjudged" }: レビューは公開されたまま配信されます

このページの読み方

レビューのボディはすべて、共通フィールドと、reviewResponse オブジェクト 1 つで構成されます。このオブジェクトは reviewResponse と metadata の 2 か所に、同じ値で送信されます。6 つのサイトはすべて同じキーを持ちます。異なるのは platform と値だけです。

すべてのレビューに共通するフィールド

reviewResponse · 全サイト
platform
'g2'|'trustpilot'|'capterra'|'trustpilot_de'|'capterra_de'|'boxil'
レビューサイト。subEventType に対応します(g2 → g2_review)。
title
string|null
レビューの見出し。サイトにない場合は null です(G2 のレビューにはありません)。
text
string|null
レビューの本文。サイトが良い点と悪い点を分けて提供する場合は、Pros: と Cons: の段落として末尾に追加されます。
url
string|null
レビューへの公開リンク。
author
object|null
レビューした人: { name: string, handle: string | null, url: string | null }。Trustpilot ではプロフィールの url が入り、G2 では名前だけです。
media
object[]
{ type: 'image' | 'video' | 'document', url: string }。通常は空配列です。
metrics
object|null
{ "rating": number }。rating と同じ数値です。
reviewId
string
サイト独自のレビュー ID。
rating
number
整数です。Trustpilot と Capterra は 1 から 5(四捨五入され、1 を下回りません)。G2、BOXIL、Capterra ドイツは 1 から 5 で、サイトが評価を提供しなかった場合は 0 です。
verified
boolean
サイトがレビューを認証済みとしている場合は true です。
pros
string|null
「気に入っている点」の部分。サイトが分けて提供する場合のみ。それ以外は null です。
cons
string|null
「気に入らない点」の部分。サイトが分けて提供する場合のみ。それ以外は null です。
reviewerRole
string|null
サイトが表示している場合の、レビューした人の役職(Administrator)。それ以外は null です。

G2

subEventType: "g2_review"、platform: "g2"。レビュー本文は text に入ります。この G2 の例には pros と cons がありません。

イベント · g2_reviewSignals の実行で得た実際のイベント
json
1{
2 "version": 1,
3 "eventId": "c75a2a21-598b-4511-94b8-ab118a6ace08",
4 "eventType": "reviews",
5 "subEventType": "g2_review",
6 "action": "new",
7 "signalType": "reviews.new",
8 "source": "reviews",
9 "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10 "trackerId": "fcc85144-6fad-4477-af3e-0f8a7d6eb671",
11 "runId": "af220478-8cb5-4711-ba5a-ef760f41cd0b",
12 "competitor": {
13 "name": "HubSpot",
14 "domain": "hubspot.com",
15 "subjectKey": "hubspot.com|-|global|g2,trustpilot"
16 },
17 "occurredAt": "2026-10-25T23:50:00.523Z",
18 "detectedAt": "2026-10-26T13:17:33.813Z",
19 "sequence": 626,
20 "itemKey": "reviews-g2-13856432",
21 "relevance": {
22 "status": "unjudged"
23 },
24 "reviewResponse": {
25 "platform": "g2",
26 "title": null,
27 "text": "Simple and powerful email editor and the ability to manage campaigns all in one place\nThe social media management tool isn't helpful without powerful scheduling and management abilities. Most people I know also use a third party for it\nIt's solving our need to send one-to-many marketing emails and track contact engagement to promote follow-ups and target specific audiences and specific segments Simple, Powerful Email …",
28 "url": "https://www.g2.com/products/hubspot-marketing-hub/reviews/hubspot-marketing-hub-review-13856432",
29 "author": {
30 "name": "Josh C.",
31 "handle": null,
32 "url": null,
33 "imageUrl": null
34 },
35 "media": [],
36 "metrics": {
37 "rating": 4
38 },
39 "reviewId": "13856432",
40 "rating": 4,
41 "verified": false,
42 "pros": null,
43 "cons": null,
44 "reviewerRole": "Administrator"
45 },
46 "metadata": {
47 "platform": "g2",
48 "title": null,
49 "text": "Simple and powerful email editor and the ability to manage campaigns all in one place\nThe social media management tool isn't helpful without powerful scheduling and management abilities. Most people I know also use a third party for it\nIt's solving our need to send one-to-many marketing emails and track contact engagement to promote follow-ups and target specific audiences and specific segments Simple, Powerful Email …",
50 "url": "https://www.g2.com/products/hubspot-marketing-hub/reviews/hubspot-marketing-hub-review-13856432",
51 "author": {
52 "name": "Josh C.",
53 "handle": null,
54 "url": null,
55 "imageUrl": null
56 },
57 "media": [],
58 "metrics": {
59 "rating": 4
60 },
61 "reviewId": "13856432",
62 "rating": 4,
63 "verified": false,
64 "pros": null,
65 "cons": null,
66 "reviewerRole": "Administrator"
67 }
68}

長いテキストはここでは「 …」で省略しています。実際には全文が届きます。

Trustpilot

subEventType: "trustpilot_review"、platform: "trustpilot"。Trustpilot では title とレビューした人のプロフィール url が入ります。reviewerRole は null です。

イベント · trustpilot_reviewSignals の実行で得た実際のイベント
json
1{
2 "version": 1,
3 "eventId": "fda86b41-6517-46fa-b833-fb6710b48f80",
4 "eventType": "reviews",
5 "subEventType": "trustpilot_review",
6 "action": "new",
7 "signalType": "reviews.new",
8 "source": "reviews",
9 "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10 "trackerId": "fcc85144-6fad-4477-af3e-0f8a7d6eb671",
11 "runId": "af220478-8cb5-4711-ba5a-ef760f41cd0b",
12 "competitor": {
13 "name": "HubSpot",
14 "domain": "hubspot.com",
15 "subjectKey": "hubspot.com|-|global|g2,trustpilot"
16 },
17 "occurredAt": "2026-10-26T11:44:48.000Z",
18 "detectedAt": "2026-10-26T13:17:33.813Z",
19 "sequence": 628,
20 "itemKey": "reviews-trustpilot-6adf21103df1c059a67db03d",
21 "relevance": {
22 "status": "unjudged"
23 },
24 "reviewResponse": {
25 "platform": "trustpilot",
26 "title": "HubSpot claims to help companies scale",
27 "text": "HubSpot claims to help companies scale, but their business practices did the exact opposite for us. We experienced aggressive vendor lock-in and were forced to hire an expensive external partner just to handle the basic system setup. Worse, they automatically charged us for hidden add-ons without our consent, and we were unable to revert or remove these unwanted features. These unforeseen contract increases severely …",
28 "url": "https://www.trustpilot.com/reviews/6adf21103df1c059a67db03d",
29 "author": {
30 "name": "Rory Jackson",
31 "handle": null,
32 "url": "https://www.trustpilot.com/users/6adf1fbb637e0e5622b46afd",
33 "imageUrl": null
34 },
35 "media": [],
36 "metrics": {
37 "rating": 1
38 },
39 "reviewId": "6adf21103df1c059a67db03d",
40 "rating": 1,
41 "verified": false,
42 "pros": null,
43 "cons": null,
44 "reviewerRole": null
45 },
46 "metadata": {
47 "platform": "trustpilot",
48 "title": "HubSpot claims to help companies scale",
49 "text": "HubSpot claims to help companies scale, but their business practices did the exact opposite for us. We experienced aggressive vendor lock-in and were forced to hire an expensive external partner just to handle the basic system setup. Worse, they automatically charged us for hidden add-ons without our consent, and we were unable to revert or remove these unwanted features. These unforeseen contract increases severely …",
50 "url": "https://www.trustpilot.com/reviews/6adf21103df1c059a67db03d",
51 "author": {
52 "name": "Rory Jackson",
53 "handle": null,
54 "url": "https://www.trustpilot.com/users/6adf1fbb637e0e5622b46afd",
55 "imageUrl": null
56 },
57 "media": [],
58 "metrics": {
59 "rating": 1
60 },
61 "reviewId": "6adf21103df1c059a67db03d",
62 "rating": 1,
63 "verified": false,
64 "pros": null,
65 "cons": null,
66 "reviewerRole": null
67 }
68}

長いテキストはここでは「 …」で省略しています。実際には全文が届きます。

Capterra

subEventType: "capterra_review"、platform: "capterra"。ボディのキーは G2 や Trustpilot と同じです。Capterra にはサンプルしかないため、サンプルのバッジ付きで表示しています。

イベント · capterra_review正確な形のサンプル(実データはまだありません)
json
1{
2 "version": 1,
3 "eventId": "efd01349-3e10-46db-ad62-22f0e1bad359",
4 "eventType": "reviews",
5 "subEventType": "capterra_review",
6 "action": "new",
7 "signalType": "reviews.new",
8 "source": "reviews",
9 "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10 "trackerId": "8ec3d16d-ba7e-45cc-94fa-584649be45db",
11 "runId": "2b8b03e3-beb1-4d4b-8332-932a5019d152",
12 "competitor": {
13 "name": "HubSpot",
14 "domain": "hubspot.com",
15 "subjectKey": "hubspot.com|-|global|capterra,trustpilot_de,capterra_de,boxil"
16 },
17 "occurredAt": "2026-10-25T09:00:00.000Z",
18 "detectedAt": "2026-10-26T13:20:00.000Z",
19 "sequence": 626,
20 "itemKey": "reviews-capterra-7712093",
21 "relevance": {
22 "status": "unjudged"
23 },
24 "reviewResponse": {
25 "platform": "capterra",
26 "title": "Great CRM for a growing sales team",
27 "text": "Pros: Easy pipeline setup and the free CRM covers most needs.\nCons: Reporting needs the paid tier.",
28 "url": "https://www.capterra.com/p/61368/HubSpot-CRM/reviews/7712093/",
29 "author": {
30 "name": "Priya S.",
31 "handle": null,
32 "url": null,
33 "imageUrl": null
34 },
35 "media": [],
36 "metrics": {
37 "rating": 4
38 },
39 "reviewId": "7712093",
40 "rating": 4,
41 "verified": true,
42 "pros": "Easy pipeline setup and the free CRM covers most needs.",
43 "cons": "Reporting needs the paid tier.",
44 "reviewerRole": "Sales Manager"
45 },
46 "metadata": {
47 "platform": "capterra",
48 "title": "Great CRM for a growing sales team",
49 "text": "Pros: Easy pipeline setup and the free CRM covers most needs.\nCons: Reporting needs the paid tier.",
50 "url": "https://www.capterra.com/p/61368/HubSpot-CRM/reviews/7712093/",
51 "author": {
52 "name": "Priya S.",
53 "handle": null,
54 "url": null,
55 "imageUrl": null
56 },
57 "media": [],
58 "metrics": {
59 "rating": 4
60 },
61 "reviewId": "7712093",
62 "rating": 4,
63 "verified": true,
64 "pros": "Easy pipeline setup and the free CRM covers most needs.",
65 "cons": "Reporting needs the paid tier.",
66 "reviewerRole": "Sales Manager"
67 }
68}

その他のサイト

trustpilot_de_review(platform: "trustpilot_de")、capterra_de_review(platform: "capterra_de")、boxil_review(platform: "boxil")は、上の例と同じキーを使います。これらについては、実際のボディではなくサンプルのボディしかないため、ここでは繰り返しません。