API一覧に戻る
Google Playの公開データ

Google Play API

既知のストアURLから、公開Google Playのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。

利用できるGoogle Play API

既知の掲載ページにはApp Detail、公開ランキングのURLにはApp Rankings、既知のアプリURLからの公開フィードバックにはApp Reviewsを使用します。

取得できるGoogle Playデータ

正規化されたアプリのスキーマでは、取得元で欠けている値を推測で補わず、公開掲載情報のフィールドを null 許容のまま保持します。

アプリの基本情報と説明文

取得可能な場合、パッケージID、アプリ名、公開されている説明文、デベロッパー、カテゴリ、取得元URLを取得します。

表示中の掲載シグナル

取得可能な評価、レビュー数、インストール数の範囲、価格、順位を、特定時点のストアの観測値として保持します。

メディアと取得時のコンテキスト

メディアのフィールドと collected_at を、正規化されたアプリのレコードとともに保持します。

Google Play APIの仕様概要

各エンドポイントは既知の公開Google Play URLを起点とし、非同期タスクワークフローを通じて正規化レコードを返します。

エンドポイント入力取得元の範囲
App DetailアプリURLの空でない配列受け付けたURLごとにアプリのレコード最大1件
App RankingsカテゴリまたはランキングのURLと、任意の results_limit送信したランキングに掲載されているアプリ
App ReviewsアプリURLと、任意の country と results_limit送信したアプリの公開レビュー

Google Play APIの仕組み

3つのエンドポイントはすべて、標準の非同期タスクワークフローを使用します。

  1. 1. 既知のURLを送信

    対応するエンドポイントを選び、必須の urls 配列と任意の設定をPOSTして、task_id を保持します。

  2. 2. タスクを追跡

    処理が成功または失敗するまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 保存済みのレコードを読み取る

    成功後に data.results.items を読み取り、SocQに保存済み結果の次のページがある場合のみ next_cursor をたどります。

Google Playのアプリ詳細を取得

SocQのAPIキーで認証し、既知の公開Google PlayのアプリURLを送信します。

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 data.results.items

Google Play APIの主なユースケース

アプリカタログの情報補完

既知のアプリリンクに、正規化された基本情報、公開されている掲載文、デベロッパー、カテゴリ、取得元のコンテキストを追加します。

選定した掲載情報の比較

管理されたURLセット全体で、取得可能な公開の価格、評価、レビュー、インストール数、メディアのフィールドを比較します。

特定時点の観測

繰り返し取得したレコードを collected_at とともに保持し、null 許容の公開掲載フィールドの推移を比較します。

制限事項と公開データポリシー

結果はその時点の公開掲載情報の表示状況によって異なり、アカウント管理や公開の機能は提供しません。

  • すべての入力アイテムは、play.google.com またはそのサブドメインのいずれかに解決される必要があります。
  • これらのAPIは、キーワードやパッケージIDのみの入力は受け付けません。対応する任意のフィールドは、選択したエンドポイントによって異なります。
  • App DetailはURLごとに最大1件のレコードを返します。RankingsとReviewsは、タスク全体で1〜2,000の results_limit を使用します。
  • タスク結果のカーソルは、SocQがすでに保存したレコードをページ分割するもので、Google Playの追加ページを取得するものではありません。
  • 最終的な請求は保存された結果1件あたり0.15クレジットで、基本料金はありません。見積もりには、App DetailではURLの件数を、RankingsとReviewsでは指定またはデフォルトの取得件数上限を使用します。

Google Play APIに関するよくある質問

Google Play APIとは何ですか?

Google Play APIは、既知のGoogle Play URLから、アプリの詳細、カテゴリランキング、公開アプリレビューを取得するAPIです。

複数のアプリURLを送信できますか?

はい。それぞれが play.google.com のホストまたは対応するサブドメインを使用する、空でない文字列の配列を送信してください。

これらのAPIでアプリを探すことはできますか?

App Rankingsは、送信したランキングURLに掲載されているアプリを見つけます。キーワード検索は提供していません。

結果の料金はどのように計算されますか?

保存された結果は1件あたり0.15 SocQクレジットです。最終的な料金は実際の結果件数に基づき、見積もりの方法は選択したエンドポイントによって異なります。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

Amazon API

対応するマーケットプレイスで公開Amazon商品を検索し、正規化された商品詳細、売れ筋ランキング、レビュー、セラーのプロフィール、クリエイターのストアフロントのレコードを取得できます。

Apple App Store API

既知のストアURLから、公開Apple App Storeのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。

SEO API

Googleのオーガニック検索結果をリアルタイムで取得し、キーワードの需要と順位獲得の難易度を比較し、シードキーワードを拡張し、サイトの検索での可視性を支えるキーワードとページを明らかにし、検索意図を分類できるほか、Googleニュース・画像・サジェスト、Bing、YouTubeの結果も集められます。すべてのエンドポイントで、共通のSocQのAPIキー、非同期タスクフロー、正規化された結果形式を使用します。

Telegram API

t.meリンクから公開Telegramチャンネルを読み取ります。登録者数付きのチャンネル情報、閲覧数とリアクション付きの投稿、個別の投稿、ディスカッショングループのコメント、類似チャンネル、全履歴の検索に対応します。

Link in Bio API

クリエイターがInstagram、TikTok、YouTubeのプロフィール欄に置く1本のリンクを、表示名、紹介文、アイコン、掲載されている連絡先メール、連携SNS、各ボタンのタイトルとリンク先という構造化データに変えます。

Creator API

Instagram、TikTok、YouTube、X、Facebook、Threadsのプロフィール1件を起点に、クリエイターの公開ビジネスメール、ほかのSNSのアカウント、プロフィール写真からの年齢・性別の推定を取得します。