Google Play App Detail
Google Playのアプリ詳細は、アプリの識別情報、説明文、デベロッパーとカテゴリの情報、表示中の評価とレビュー件数、インストール数の範囲、価格、メディアを含む公開ストア掲載レコードです。これらのフィールドは、カタログ情報の補完、選定アプリの比較、特定時点のモニタリングに活用できます。
Google Play App Detail API の主な機能
- 既知URLによる一括取得1つ以上のplay.google.comアプリURLを送信して詳細を直接取得します。リクエストがキーワード検索になることはありません。
- 掲載情報と説明文パッケージ識別子、アプリ名、公開ストアの説明文、デベロッパー、カテゴリ、取得元URL、取得日時を正規化します。
- 表示中のマーケット情報取得できた評価、レビュー件数、インストール数の範囲、価格、順位の各フィールドを、公開掲載ページからの観測値(null許容)として保持します。
- メディアを含むアプリレコード安定したアプリスキーマとあわせてメディアを返すため、掲載レコードを他のSocQデータと同じ非同期結果ワークフローで扱えます。
Google Play App Detail API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。解析後のホスト名がplay.google.comまたはそのサブドメインである、既知のアプリURLの空でない文字列配列です。受け付けられたURL 1件につき1回の詳細取得となります。 |
Google Play App Detail API の使い方
既知のGoogle Play URLを送信して非同期タスクを追跡し、完了後に正規化されたアプリレコードを読み取ります。
- 解析後のホスト名がplay.google.comまたは対応するサブドメインであるアプリリンクを含む、空でない urls 配列を用意します。
- 配列を /v1/google-play/app-detail に POST し、返された task_id を保存します。
- タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- 成功したら data.results.items を読み取ります。next_cursor は has_more が true の場合のみ使用してください。これはSocQに保存済みのレコードをページ送りするもので、Google Playの別のソースページを取得するものではありません。
curl -X POST "https://api.socq.ai/v1/google-play/app-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/details?id=com.openai.chatgpt"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized app records from data.results.itemsGoogle Play App Detail API の主なユースケース
- 既知アプリカタログの情報補完: 保存済みのGoogle Playリンクを、正規化されたパッケージID、タイトル、説明文、デベロッパー、カテゴリ、取得元URL、取得タイムスタンプに変換します。
- 選定した掲載情報の比較: 承認済みのアプリURL群について、取得できた評価、レビュー件数、インストール数の範囲、価格、カテゴリ、メディアの各フィールドを揃えて比較します。
- 掲載情報のスナップショット監視: 決まったスケジュールで取得を繰り返し、null許容の掲載フィールドを collected_at とあわせて比較することで、特定時点の変化を把握します。
Google Play App Detail API 活用のヒント
- 見積もりが意図した取得件数を反映するよう、完全なGoogle PlayアプリURLを使用し、送信前に配列の重複を排除してください。
- 入力URLごとに返される結果は最大1件です。受け付けられたURLでも項目が返らない場合があるため、返されたレコードは url または app_id で照合してください。
- 公開掲載フィールドは欠落したり取得後に変化したりすることがあるため、評価、レビュー件数、インストール数の範囲、価格、順位、メディアは欠損を前提に保存してください。
- next_cursor は完了したタスクの保存済みSocQ結果を読み進めるためだけに使用してください。この詳細エンドポイントは、Google Playの検索やソースページのページネーションを提供しません。
関連API
Google Play App Detail API 以外に別の種類の公開Google Playデータが必要な場合は、これらのAPIをご利用ください。
- Google Play App Rankings API
- Google Play App Reviews API — play.google.comのURLから公開アプリレビューを取得します。国を任意で指定でき、正規化された本文、レビュー投稿者、評価、日時、アプリの参照の各フィールドを返します。