google-play/
app-detail

既知のplay.google.comのURLから公開Google Playアプリの詳細を取得し、アプリ情報、ストア掲載文、デベロッパー、カテゴリ、表示中の指標、価格、メディアを正規化レコードとして返します。

Google Play App Detail API

既知のアプリURL
詳細の一括取得
結果単位の課金
結果1件あたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を送信して非同期タスクを追跡し、完了後に正規化されたアプリレコードを読み取ります。

  1. 解析後のホスト名がplay.google.comまたは対応するサブドメインであるアプリリンクを含む、空でない urls 配列を用意します。
  2. 配列を /v1/google-play/app-detail に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら 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.items

Google 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の検索やソースページのページネーションを提供しません。

Google Play App Detail API 以外に別の種類の公開Google Playデータが必要な場合は、これらのAPIをご利用ください。

  • Google Play App Rankings API
  • Google Play App Reviews API — play.google.comのURLから公開アプリレビューを取得します。国を任意で指定でき、正規化された本文、レビュー投稿者、評価、日時、アプリの参照の各フィールドを返します。

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

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

Google Play App Detail API — よくある質問

Google Play App Detail APIは、既知のGoogle PlayアプリURLから公開ストア掲載の詳細を取得するためのプログラムインターフェースです。取得可能な場合、正規化されたアプリ情報、掲載文、デベロッパー、カテゴリ、表示中の指標、価格、メディア、取得時の情報を返します。

空でない urls 配列を送信します。各要素は、解析後のホスト名がplay.google.comまたはそのサブドメインである文字列でなければなりません。

できません。既知のURLごとに詳細を取得し、そのURLについて最大1件の正規化レコードを返します。URLが受け付けられても、公開項目が取得できるとは限りません。

アプリスキーマには、ID、取得元URL、パッケージID、名前、テキスト、デベロッパー、カテゴリ、評価、レビュー件数、インストール数の範囲、価格、順位、メディア、取得日時が含まれる場合があります。取得できない公開フィールドは null になることがあります。

見積もりは送信したURL数に基づき、1件あたり0.15 SocQクレジットで計算されます。最終的な請求は基本料金0クレジット、返された結果1件につき0.15クレジットです。そのため、タスクが成功してもレコードが返らなかった場合の最終請求額は0クレジットです。