App Store検索API

POST

APIの稼働状況

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

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

正常

過去24時間

過去30日間

アプリ名またはカテゴリでApp Storeを検索します。各アプリのID、バンドルID、デベロッパ、バージョン、価格、評価、リリース日を取得できます。ストアの国はcountryで選択します（デフォルトはUS）。ダウンロード数、収益、キーワード順位の履歴は含まれません。

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

AIプロンプト

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

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにapp_store、actionにsearchを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - keyword: App Storeの検索語句（例：habit trackerやアプリ名）を指定します。Bundle IDは指定しないでください。以降のアプリ詳細やレビューのリクエストには、検索結果で返される数値のapp_idを使用します。
- 任意パラメータ：
  - country: search、profile、reviewsで使用するApp Storeのストアフロントを、us、cn、jpなどの小文字2文字の国コードで選択します。デフォルトはusです。変わるのは照会するストアフロントで、アカウントの地域やEveryInfraの課金は変わりません。
  - limit: この呼び出しで返す最大行数で、1〜200の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。（デフォルト：20）
- レコードのリストを返します。各レコードの主なフィールド: app_id、name、url、bundle_id、developer、developer_id、developer_url、description、release_notes、version、price、currency。フィールドは全部で28個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=app_storeを参照してください。.
- リクエストボディの例：
{
  "platform": "app_store",
  "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`	はい	`app_store`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`search`	機能の識別子です。値は固定です。
`keyword`	body.params	`string`	はい	-	App Storeの検索語句（例：habit trackerやアプリ名）を指定します。Bundle IDは指定しないでください。以降のアプリ詳細やレビューのリクエストには、検索結果で返される数値のapp_idを使用します。
`country`	body.params	`string`	いいえ	-	search、profile、reviewsで使用するApp Storeのストアフロントを、us、cn、jpなどの小文字2文字の国コードで選択します。デフォルトはusです。変わるのは照会するストアフロントで、アカウントの地域やEveryInfraの課金は変わりません。
`limit`	body.params	`integer (1–200)`	いいえ	`20`	この呼び出しで返す最大行数で、1〜200の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に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": "app_store",
  "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": "app_store",
  "action": "search",
  "results": [
    {
      "app_id": 1438388363,
      "name": "Habit Tracker",
      "url": "https://apps.apple.com/us/app/habit-tracker/id1438388363?uo=4",
      "bundle_id": "com.davetech.habit",
      "developer": "InnerGrow",
      "developer_url": "https://apps.apple.com/us/developer/innergrow/id1828382777?uo=4",
      "description": "Habit Tracker: A simple daily planner to schedule and track your routine, making it easy to build lasting habits. \nJoin 15M+ happy users, achieve your goals, and make every day count!\nMore than a self-care companion, it lets you share with others to grow and improve together. \n\n-…",
      "release_notes": "- add shortcut supports \n- add custom repeat interval \n- fix bugs\n----- Beta Tester needed -----\nIf you want to help us to test new version, contact us: •••\nIf your widget is not working, restart your iPhone.\nOur IG: Tiny Useful Apps",
      "version": "2.14.23",
      "price": 0,
      "currency": "USD",
      "formatted_price": "Free",
      "rating": 4.79,
      "rating_count": 147260,
      "current_version_rating_count": 147260,
      "content_rating": "4+",
      "category": "Productivity",
      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/d3/ef/00/d3ef00c2-9b1c-b5ef-0464-2e08231b80de/AppIcon-pink-gr-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
      "min_os": "15.0",
      "file_size_bytes": 339836928,
      "released_at": "2019-01-31T09:10:14+00:00",
      "updated_at": "2026-08-15T15:18:18+00:00",
      "platform": "app_store",
      "genres": [
        "Productivity",
        "Health & Fitness"
      ],
      "languages": [
        "EN",
        "FR",
        "DE"
      ],
      "screenshot_urls": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/5c/b8/05/5cb8051e-e125-e84e-f0b5-2551b6e9d69d/_U767d1.jpg/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/13/5d/32/135d32df-678d-5c7e-d940-4f16d5c4e396/_U767d2.jpg/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/2e/a8/66/2ea866a0-2271-4d8a-e380-8386b935283f/_U767d3.jpg/320x480bb.jpg"
      ],
      "rating_scale": 5
    },
    {
      "app_id": 6443918070,
      "name": "Habit Tracker - HabitKit",
      "url": "https://apps.apple.com/us/app/habit-tracker-habitkit/id6443918070?uo=4",
      "bundle_id": "com.roehl.habitkit",
      "developer": "Sebastian Roehl",
      "developer_url": "https://apps.apple.com/us/developer/sebastian-roehl/id1602956482?uo=4",
      "description": "Big life changes do not start big. They start with one small habit, done today, done again tomorrow. HabitKit turns those daily wins into a colorful grid of tiles, one square for every day you show up, so you can finally see yourself becoming the person you want to be.\n\nThat visi…",
      "release_notes": "- Choose Yes/No, Count or Measure with decimals and custom units\n- Change habit types without losing history or streaks\n- At a Count goal above 1, tap to edit instead of clearing\n- New iOS Shortcuts to log amounts and notes, get progress and open habits; translated labels and cle…",
      "version": "1.18.0",
      "price": 0,
      "currency": "USD",
      "formatted_price": "Free",
      "rating": 4.85,
      "rating_count": 2430,
      "current_version_rating_count": 2430,
      "content_rating": "4+",
      "category": "Productivity",
      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/79/91/fe/7991fe78-b459-1397-205f-54525a639bde/NewAppIcon-0-0-1x_U007ephone-0-1-sRGB-85-220.png/512x512bb.jpg",
      "min_os": "15.0",
      "file_size_bytes": 230910976,
      "released_at": "2022-11-26T08:00:00+00:00",
      "updated_at": "2026-09-21T08:40:41+00:00",
      "platform": "app_store",
      "genres": [
        "Productivity"
      ],
      "languages": [
        "AR",
        "BE",
        "CA"
      ],
      "screenshot_urls": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/cb/27/c1/cb27c143-49f7-12ba-a1f1-68fd4caf0634/Apple_iPhone_11_Pro_Max_Screenshot_0.png/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/18/ba/4e/18ba4eac-d29a-94ae-88a5-92204e14eb24/Apple_iPhone_11_Pro_Max_Screenshot_1.png/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/23/59/4e/23594e53-c451-7772-0dbb-7cd58b8470bb/Apple_iPhone_11_Pro_Max_Screenshot_2.png/320x480bb.jpg"
      ],
      "rating_scale": 5
    }
  ],
  "count": 18,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

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

フィールド	意味
`app_id`	プラットフォーム上の意味のまま
`name`	対象そのものの名前です（アカウント・商品・ビジネス系の機能で使用）。
`url`	プラットフォーム上のレコードへのリンクです。
`bundle_id`	プラットフォーム上の意味のまま
`developer`	プラットフォーム上の意味のまま
`developer_id`	プラットフォーム上の意味のまま
`developer_url`	プラットフォーム上の意味のまま
`description`	概要または説明文で、通常はtextより短くなります。
`release_notes`	プラットフォーム上の意味のまま
`version`	プラットフォーム上の意味のまま
`price`	通貨記号を含まない数値で表した価格です。通貨についてはcurrencyを参照してください。
`currency`	価格の通貨コードです（例：CNY、USD）。priceフィールドが存在してもcurrencyがnullの場合は、通貨を推測しないでください。
`formatted_price`	プラットフォーム上の意味のまま
`rating`	評価です。スケールはプラットフォームによって異なります。最大値は同じ行のrating_scaleで示されます（通常は5。Booking、Douban、iQIYI、NAVERは10）。プラットフォーム間で比較する前にrating_scaleで換算してください。換算しないと比較結果が逆転することがあります。
`rating_scale`	同じ行のratingの最大値です。5段階評価では5、10点満点では10になります。行にratingがある場合のみ含まれます。
`rating_count`	評価した人数です。nullは非公開を示し、0ではありません。
`current_version_rating`	プラットフォーム上の意味のまま
`current_version_rating_count`	プラットフォーム上の意味のまま
`content_rating`	プラットフォーム上の意味のまま
`category`	プラットフォーム独自の分類体系におけるカテゴリ名です。プラットフォーム間で正規化されていません。
`icon_url`	プラットフォーム上の意味のまま
`min_os`	プラットフォーム上の意味のまま
`file_size_bytes`	プラットフォーム上の意味のまま
`released_at`	プラットフォーム上の意味のまま
`updated_at`	プラットフォーム上の意味のまま
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。
`genres`	プラットフォーム上の意味のまま
`languages`	プラットフォーム上の意味のまま
`screenshot_urls`	プラットフォーム上の意味のまま

エラーと課金

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

エラー