apple-app-store/
app-reviews

1つ以上のapps.apple.comのURLから公開Apple App Storeレビューを収集し、レビュー本文、評価、投稿者情報、タイムスタンプ、アプリ情報を正規化レコードとして返します。

Apple App Store App Reviews API

既知のアプリURL
公開レビュー本文と評価
投稿者とアプリの情報
結果1件あたり0.15クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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を送信して非同期タスクを追跡し、完了したタスクに保存されたレビューレコードをページ単位で読み取ります。

  1. 解析後のホスト名がapps.apple.comであるアプリの参照を1つ以上用意し、必要に応じて1〜2,000の範囲で results_limit を指定します。
  2. ペイロードを /v1/apple-app-store/app-reviews に POST し、返された task_id を保存します。
  3. status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
  4. 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 true

Apple 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 のフィールドを省略してください。

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から公開カテゴリランキングの項目を取得し、元の順位、アプリ情報、デベロッパー、評価、レビュー数、価格、メディアの各フィールドを返します。

他のプラットフォームを見る

Apple App Storeのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Apple App Store App Reviews API — よくある質問

Apple App Store App Reviews APIは、既知のApple App StoreアプリURLから公開ユーザーレビューを収集するためのプログラムインターフェースです。取得できる場合は、正規化されたレビュー本文、評価、投稿者情報、タイムスタンプ、メディア、アプリ参照を返します。

urls は必須で、解析後のホスト名がapps.apple.comまたはそのサブドメインである空でない参照を1つ以上含める必要があります。絶対URLとプロトコル相対の形式を受け付けます。results_limit は任意で、デフォルトは100、1〜2,000の整数を指定できます。

いいえ。results_limit は送信したURLリスト全体でタスクに保存されるレコードの総数を制限します。個別の上限が必要な場合は、収集目的ごとにタスクを分けてください。

できません。next_cursor は、タスクの成功後にSocQがすでに保存したレコードをページ単位で読み進めるためのものです。公開リクエストでは、ソース側の追加ページを取得するためのプロバイダーカーソルは提供されていません。

正常に保存されたレビュー1件につき0.15 SocQクレジットです。results_limit を省略した場合は100件分で見積もられます。設定されている基本料金は0のため、保存されたレビューがないタスクには結果の料金は発生しません。