Apple App Store App Reviews
Apple App Storeのアプリレビューは、レビュー本文、評価、投稿者の識別情報、公開日時、レビュー対象アプリへのリンクを含む公開ユーザーフィードバックです。これらのレコードは、フィードバック分析、評価の比較、アプリカタログの情報補完、時系列のモニタリングに活用できます。
Apple App Store App Reviews API の主な機能
- 既知アプリURLの一括送信1つのタスクで1つ以上のapps.apple.comの製品URLを送信し、そのリクエストで保存するレビューレコードの総数を results_limit で1つ指定できます。
- 正規化された公開レビューレコード共通のレビュースキーマを通じて、レビュー本文、数値の評価、投稿者の識別情報、任意のメディア、固定のレコードフィールドを読み取れます。
- アプリと取得時の情報取得できた各レビューを対象の識別子またはアプリURLに関連付け、公開日時と取得日時のタイムスタンプを保持して追跡可能なスナップショットにします。
Apple App Store App Reviews API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。解析後のホスト名がapps.apple.comまたはそのサブドメインである、空でないアプリ参照のリストです。絶対URLとプロトコル相対の値を受け付けます。プレイグラウンドではカンマまたは改行で区切って入力します。 |
results_limit | 任意 | 任意。タスクで保存するレビューレコードの総数の上限を指定する1〜2,000の正の整数です。バックエンドのデフォルトは100です。 |
Apple App Store App Reviews API の使い方
既知のアプリURLを送信して非同期タスクを追跡し、完了したタスクに保存されたレビューレコードをページ単位で読み取ります。
- 解析後のホスト名がapps.apple.comであるアプリの参照を1つ以上用意し、必要に応じて1〜2,000の範囲で results_limit を指定します。
- ペイロードを /v1/apple-app-store/app-reviews に POST し、返された task_id を保存します。
- status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は next_cursor を使って続きを取得します。
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueApple App Store App Reviews API の主なユースケース
- アプリのフィードバック確認: レビュー本文、評価値、投稿者の情報を使って、既知のアプリページについて返された公開フィードバックを確認します。
- アプリ間の評価比較: 正規化レコードを対象の識別子またはアプリURLでグループ化し、送信した製品間で評価の分布を比較します。
- レビューの時系列スナップショット: 公開日時と取得日時のタイムスタンプをレビューIDとともに保持し、新たに取得したレコードと以前のスナップショットを区別します。
Apple App Store App Reviews API 活用のヒント
- 送信前に、各入力のホスト名がapps.apple.comであることを確認してください。サブドメインとプロトコル相対の参照は受け付けられますが、それ以外のホストは拒否されます。
- results_limit はアプリごとではなくタスク全体の合計として指定してください。省略した場合は100が使われ、指定できる上限は2,000です。
- next_cursor は保存済みのSocQ結果を追加で読み取るためだけに使ってください。プロバイダーの次のページを要求したり、ソース側の収集を継続したりするものではありません。
- 本文、投稿者の詳細、評価、アプリ参照、メディアが欠けている場合は不明として扱い、後続の表示では null のフィールドを省略してください。
関連API
Apple App Store App Reviews API 以外に別の種類の公開Apple App Storeデータが必要な場合は、これらのAPIをご利用ください。
- Apple App Store App Detail API — 既知のApp Store掲載URLから、正規化された公開アプリ情報、説明メタデータ、デベロッパーとカテゴリの情報、表示中の評価、価格、メディアを取得します。
- Apple App Store Rankings API — 対応するApple App StoreのURLから公開カテゴリランキングの項目を取得し、元の順位、アプリ情報、デベロッパー、評価、レビュー数、価格、メディアの各フィールドを返します。