Google Play検索API

POST

APIの稼働状況

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

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

正常

過去24時間

過去30日間

アプリ名や用途でGoogle Playのアプリを検索します。パッケージID、デベロッパー、評価、インストール数の範囲、価格、カテゴリ、コンテンツのレーティング、最終更新日を取得できます。返されたapp_idは詳細やレビューの取得に使えます。installsは範囲の下限値で、正確な数ではありません。

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

AIプロンプト

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

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにgoogle_play、actionにsearchを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - keyword: Google Playのアプリ名または用途のクエリです（例：note taking）。パッケージ名の完全一致検索ではありません。アプリの詳細とレビューにはapp_idを使用してください。
- 任意パラメータ：
  - country: Google Playストアフロントの国または地域を、usなどの小文字のコードで選択します。デフォルトはusです。searchとprofileでは照会するストアフロントが変わりますが、ユーザーの端末の地域や開発者の国籍が変わるわけではありません。reviewsでは返されるレビューは変わりません。レビューはlanguageによってのみ変わるため、同じ言語であればusとgbで同じレビューが返されます。
  - language: Play Storeのコンテンツとレビューのクエリに使用する言語を選択します（例：en、zh）。デフォルトはenです。国が自動的に変わることはなく、返されるすべてのレビューがその言語で書かれていることを保証するものでもありません。
  - page_token: ページネーショントークンです。次のページを取得するには、前回のレスポンスのnext_page_tokenを渡します。最初のページでは省略してください。他のパラメータはすべて変更しないでください。トークンの有効期限は24時間で、1ページごとに1回の呼び出しとなります。
  - limit: この呼び出しで返す最大行数で、1〜100の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。（デフォルト：20）
- レコードのリストを返します。各レコードの主なフィールド: 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": "search",
  "params": {
    "keyword": "habit tracker"
  }
}
- 料金：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`	はい	`search`	機能の識別子です。値は固定です。
`keyword`	body.params	`string`	はい	-	Google Playのアプリ名または用途のクエリです（例：`note taking`）。パッケージ名の完全一致検索ではありません。アプリの詳細とレビューには`app_id`を使用してください。
`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です。国が自動的に変わることはなく、返されるすべてのレビューがその言語で書かれていることを保証するものでもありません。
`page_token`	body.params	`string`	いいえ	-	ページネーショントークンです。次のページを取得するには、前回のレスポンスのnext_page_tokenを渡します。最初のページでは省略してください。他のパラメータはすべて変更しないでください。トークンの有効期限は24時間で、1ページごとに1回の呼び出しとなります。
`limit`	body.params	`integer (1–100)`	いいえ	`20`	この呼び出しで返す最大行数で、1〜100の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。

コードサンプル

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": "search",
  "params": {
    "keyword": "habit tracker"
  }
}'

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

レスポンス例

実際のレスポンス

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

json

{
  "id": "req_…",
  "platform": "google_play",
  "action": "search",
  "results": [
    {
      "app_id": "org.isoron.uhabits",
      "url": "https://play.google.com/store/apps/details?id=org.isoron.uhabits",
      "name": "Loop Habit Tracker",
      "summary": "Create good habits and track their progress over time",
      "description": "Loop helps you create and maintain good habits, allowing you to achieve your long-term goals. Detailed charts and statistics show you how your habits improved over time. The app is completely ad-free, open source and it respects your privacy.\n\n\nSimple, beautiful and modern interf…",
      "developer": "Álinson S Xavier",
      "developer_email": "•••",
      "score": 4.7175927,
      "rating_count": 63336,
      "review_count": 3419,
      "installs": "5,000,000+",
      "min_installs": 5000000,
      "price": 0,
      "is_free": true,
      "currency": "USD",
      "category": "Productivity",
      "content_rating": "Everyone",
      "contains_ads": false,
      "offers_iap": false,
      "version": "2.3.1",
      "released": "Feb 22, 2016",
      "updated_at": "2025-09-14T22:56:06.000Z",
      "android_version": "9",
      "icon_url": "https://play-lh.googleusercontent.com/p0AgkzxC9Vus-E82psxrb7p8VtrVJMfXKcU9hNTW8tTG7G3yAGBqxCIyUmwibUyT1Mx7DAzkrJnPLo4VEYDwlbI",
      "header_image_url": "https://play-lh.googleusercontent.com/saJuIprQv_9zeut6372XuLUEWSSB9iAJIwFc2oASfly5r3AQaNZiVWQ9_Rc1fLe2Y4bNF6fljlze-I7yorTP",
      "privacy_policy": "http://loophabits.org/privacy",
      "platform": "google_play",
      "screenshots": [
        "https://play-lh.googleusercontent.com/KrxN9bOtspk63xhtNJx2uyaHZ3GOYK_IJ-VRIhMlh2ChFCQuBxXLWoRJd48uFRU_Rk97Nz3gHiI0eteLn2KDFQ",
        "https://play-lh.googleusercontent.com/2nZZDFddPS4-wHVgPvAfeYik3vMTsrV-Mgys3g1A6s-KLCcUWsf1PlYLJfKXGyxUnUHkSKX8sESQkrEx6mQN",
        "https://play-lh.googleusercontent.com/8BBDln1lKgX6ErWkH-_tKlfoD2TEfpcVzrgFlzJO91wK0HiYac_W0wJV7hHhGi8aeqk-8xRI051bK6mlsOLiZw"
      ],
      "rating_histogram": {
        "1": 1850,
        "2": 871,
        "3": 1850,
        "4": 4096,
        "5": 54630
      }
    },
    {
      "app_id": "com.habitnow",
      "url": "https://play.google.com/store/apps/details?id=com.habitnow",
      "name": "HabitNow Daily Routine Planner",
      "summary": "To-do list, Habit Tracker, Routine Planner and Reminders. All in just one app!",
      "description": "Maximize Your Productivity with HabitNow: Your Ultimate Todo List and Habit Tracker! 🚀\nKeeping your life organized has never been easier! With HabitNow, efficiently manage your school schedule, house chores, work, and more, all while building strong habits. Enter your routine, re…",
      "developer": "HabitNow Apps",
      "developer_email": "•••",
      "score": 4.7406015,
      "rating_count": 92815,
      "review_count": 2861,
      "installs": "5,000,000+",
      "min_installs": 5000000,
      "price": 0,
      "is_free": true,
      "currency": "USD",
      "category": "Productivity",
      "content_rating": "Everyone",
      "contains_ads": false,
      "offers_iap": true,
      "version": "2.5.4a",
      "released": "May 17, 2019",
      "updated_at": "2026-07-26T22:27:33.000Z",
      "android_version": "6.0",
      "icon_url": "https://play-lh.googleusercontent.com/HsjWZ5h3QDDNPL-0xKP9j4CXG6dxaojS2PtyuRnylitzLm5huDOCMkwc8gYF1glrr1laiRNospq5uNB0HUIo",
      "header_image_url": "https://play-lh.googleusercontent.com/rFBjMvOr9AMlbcXyoEcCmd68k7yOPeEwbfmaZar1Anz5nfZZxQvEoWOTj914GRyunw4rCEHtbbt_mtMUivcncQ",
      "privacy_policy": "https://www.habitnow.app/privacy-policy",
      "platform": "google_play",
      "screenshots": [
        "https://play-lh.googleusercontent.com/4_x2XH6oemmQ0_d9X_k7sRvq_yQmrb3lUB4ZA7WNZCDhn_kQ9zRzZS2XffNEbBnVcDK-fCm-NowhjTs0VdQJcO8",
        "https://play-lh.googleusercontent.com/58H0BAGBiSYeRYK4pixVsgYyebULGiYM2S1mBgxTWCFfGS11wbO4uo0e9eF3JmtFWJ99xgnQEh3-ufpmVztj1Q",
        "https://play-lh.googleusercontent.com/Nwb7e4hd53oPd6WyCGKeT-4Q4yBwe4o7oDUdD6Lbpg3RZp-fpkgXceqIs6PLL1Xon8DaxMeZxPGn6XWB6JQDwG8"
      ],
      "rating_histogram": {
        "1": 2315,
        "2": 802,
        "3": 2315,
        "4": 7666,
        "5": 79668
      }
    }
  ],
  "next_page_token": …,
  "pagination": { … },
  "count": 20,
  "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（空）: データがありません。課金はされません。

エラー