Google Play詳細API

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

パッケージ名を指定して、Google PlayのAndroidアプリを1件取得します。バージョン、最低Androidバージョン、価格、広告の有無、アプリ内課金、評価の分布、プライバシーポリシーを取得できます。完全なリンクではなく、PlayのURLの?id=以降の値（com.example.appなど）を指定してください。

料金は1,000リクエストあたり$1.39（1回あたり$0.001389）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのGoogle Play 詳細エンドポイント（google_play/profile）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにgoogle_play、actionにprofileを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - app_id: Play StoreのURLの?id=の値であるAndroidパッケージ名です（例：com.example.app）。Apple App Storeの数値IDではありません。Play URL全体ではなく、パッケージ名を渡してください。
- 任意パラメータ：
  - country: Google Playストアフロントの国または地域を、usなどの小文字のコードで選択します。デフォルトはusです。searchとprofileでは照会するストアフロントが変わりますが、ユーザーの端末の地域や開発者の国籍が変わるわけではありません。reviewsでは返されるレビューは変わりません。レビューはlanguageによってのみ変わるため、同じ言語であればusとgbで同じレビューが返されます。
  - language: Play Storeのコンテンツとレビューのクエリに使用する言語を選択します（例：en、zh）。デフォルトはenです。国が自動的に変わることはなく、返されるすべてのレビューがその言語で書かれていることを保証するものでもありません。
- 1つのオブジェクトを返します。主なフィールド: app_id、url、name、summary、description、developer、developer_email、developer_website、score、rating_count、review_count、installs。フィールドは全部で29個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=google_playを参照してください。.
- リクエストボディの例：
{
  "platform": "google_play",
  "action": "profile",
  "params": {
    "app_id": "com.whatsapp"
  }
}
- 料金：1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`google_play`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`profile`	機能の識別子です。値は固定です。
`app_id`	body.params	`string`	はい	-	Play StoreのURLの`?id=`の値であるAndroidパッケージ名です（例：`com.example.app`）。Apple App Storeの数値IDではありません。Play URL全体ではなく、パッケージ名を渡してください。
`country`	body.params	`string`	いいえ	-	Google Playストアフロントの国または地域を、usなどの小文字のコードで選択します。デフォルトはusです。searchとprofileでは照会するストアフロントが変わりますが、ユーザーの端末の地域や開発者の国籍が変わるわけではありません。reviewsでは返されるレビューは変わりません。レビューは`language`によってのみ変わるため、同じ言語であればusとgbで同じレビューが返されます。市場ごとにレビューを比較するには、`country`だけでなく`language`を変更してください。
`language`	body.params	`string`	いいえ	-	Play Storeのコンテンツとレビューのクエリに使用する言語を選択します（例：en、zh）。デフォルトはenです。国が自動的に変わることはなく、返されるすべてのレビューがその言語で書かれていることを保証するものでもありません。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "google_play",
  "action": "profile",
  "params": {
    "app_id": "com.whatsapp"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "google_play",
  "action": "profile",
  "results": {
    "app_id": "com.whatsapp",
    "url": "https://play.google.com/store/apps/details?id=com.whatsapp",
    "name": "WhatsApp Messenger",
    "summary": "Simple. Reliable. Private.",
    "description": "WhatsApp from Meta is a FREE messaging and video calling app. It’s used by over 2B people in more than 180 countries. It’s simple, reliable, and private, so you can easily keep in touch with your friends and family. WhatsApp works across mobile and desktop even on slow connection…",
    "developer": "WhatsApp LLC",
    "developer_email": "•••",
    "developer_website": "http://www.whatsapp.com/",
    "score": 4.6162252,
    "rating_count": 244448648,
    "review_count": 1952559,
    "installs": "10,000,000,000+",
    "min_installs": 10000000000,
    "price": 0,
    "is_free": true,
    "currency": "USD",
    "category": "Communication",
    "content_rating": "Everyone",
    "contains_ads": false,
    "offers_iap": true,
    "version": "VARY",
    "released": "Oct 18, 2010",
    "updated_at": "2026-09-19T00:49:04.000Z",
    "android_version": "Varies with device",
    "icon_url": "https://play-lh.googleusercontent.com/Gqxk4T0uZsDwFp07DE-508hkyvcNmgFuRwPiwTEfF7D7OzGv1FdHDzEyMxNsSBZLOJlGpe3ULvVM2RgrRAlBqA",
    "header_image_url": "https://play-lh.googleusercontent.com/eLX_xvno2Kq_zvpkkP8yPBRfo2TEQSrv7m7WrQ6xloPsDRJ85XQ28kGYuoR-_EBWh2Uoq2GMlDvlBEIxHRyhuSg",
    "privacy_policy": "https://www.whatsapp.com/legal/privacy-policy",
    "platform": "google_play",
    "screenshots": [
      "https://play-lh.googleusercontent.com/GQF4h3VL-kklOrVS_f1QRAJJZa2zQyVNcFbKdOIkvI_Pcu1op0Sy3uiryiTxpdcCDs7vEDA9eq0eWbxo0fx_wc8",
      "https://play-lh.googleusercontent.com/Q042rTbs53V_jW_c5fMqnNLCf-FBKiO2KiFKJJACa65oMCkaxqDSFKPQ7TH8nYetS-js-fMV7ptXSsF-aCkvcw",
      "https://play-lh.googleusercontent.com/EefxorXU8H0etXPHJsq4Nao8Npj7FqVT_h5rumnUS9KvIN7i-3WRotwduyEGi1Zg33BFHcuYRjQ0i01I3zJS"
    ],
    "rating_histogram": {
      "1": 10906306,
      "2": 3474926,
      "3": 8938533,
      "4": 21886032,
      "5": 199242772
    }
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`app_id`	プラットフォーム上の意味のまま
`url`	プラットフォーム上のレコードへのリンクです。
`name`	対象そのものの名前です（アカウント・商品・ビジネス系の機能で使用）。
`summary`	プラットフォーム上の意味のまま
`description`	概要または説明文で、通常はtextより短くなります。
`developer`	プラットフォーム上の意味のまま
`developer_email`	プラットフォーム上の意味のまま
`developer_website`	プラットフォーム上の意味のまま
`score`	プラットフォーム上の意味のまま
`rating_count`	評価した人数です。nullは非公開を示し、0ではありません。
`review_count`	レビュー数です（商品・ビジネス系の機能で使用）。nullは非公開を示し、0ではありません。
`installs`	プラットフォーム上の意味のまま
`min_installs`	プラットフォーム上の意味のまま
`price`	通貨記号を含まない数値で表した価格です。通貨についてはcurrencyを参照してください。
`is_free`	アプリを無料でダウンロードできるかどうか（keywords_for_app）。
`currency`	価格の通貨コードです（例：CNY、USD）。priceフィールドが存在してもcurrencyがnullの場合は、通貨を推測しないでください。
`category`	プラットフォーム独自の分類体系におけるカテゴリ名です。プラットフォーム間で正規化されていません。
`content_rating`	プラットフォーム上の意味のまま
`contains_ads`	プラットフォーム上の意味のまま
`offers_iap`	プラットフォーム上の意味のまま
`version`	プラットフォーム上の意味のまま
`released`	プラットフォーム上の意味のまま
`updated_at`	プラットフォーム上の意味のまま
`android_version`	プラットフォーム上の意味のまま
`icon_url`	プラットフォーム上の意味のまま
`header_image_url`	プラットフォーム上の意味のまま
`privacy_policy`	プラットフォーム上の意味のまま
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。
`screenshots`	プラットフォーム上の意味のまま
`rating_histogram`	プラットフォーム上の意味のまま

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー