App Store詳細API

Q: app_idはどこで確認できますか？

アプリのApp Storeページで確認できます。リンク内のidの後ろの数字がapp_idで、たとえばid389801252で終わるリンクなら389801252です。リンク全体を渡すこともでき、その場合はIDが抽出されます。com.example.appのようなバンドルIDではアプリを特定できません。バンドルIDはbundle_idで返されます。「App Store検索」の結果にもapp_idが含まれます。

Q: 国によって詳細が異なるのはなぜですか？

App Storeのストアフロントはそれぞれ独立しています。countryにus、cn、jpなどの小文字のコードを指定してストアフロントを選ぶと、そのストアから詳細を取得します。あるストアフロントには掲載されていても別のストアフロントには掲載されていないことがあり、価格や評価もストアによって異なる場合があるため、比較する数値にはそれぞれストアフロントを記録してください。

Q: ratingとcurrent_version_ratingのどちらを使うべきですか？

ratingとrating_countは全バージョンを通した数値で、current_version_ratingとcurrent_version_rating_countは現在ストアに公開されているバージョンのみを対象とします。デザインの刷新や多数報告されていた不具合の修正の後は、現在のバージョンの数値のほうが今のアプリの評価をよく表します。新しいバージョンはまだ評価数が少ない場合があるため、まず件数を確認してください。

POST

APIの稼働状況

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

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

正常

過去24時間

過去30日間

数値のapp_idを指定して、1つのアプリのApp Store掲載情報を取得します。デベロッパ、バンドルID、バージョン、リリースノート、価格、年齢区分、現行バージョンの評価が含まれます。App Storeのアプリページの完全なURLも使用できますが、バンドルIDは使用できません。このレコードは現在公開中の掲載情報を示すもので、App Store Connectのデータや過去のバージョンの情報は含まれません。

「App Store詳細」は、app_idで指定した1つのアプリのApple App Storeの掲載情報を取得し、そのレコードを返します。内容は、名前、デベロッパー、バンドルID、説明、リリースノート、現在のバージョン、価格、全バージョンおよび現在のバージョンの評価と評価数、年齢制限レーティング、カテゴリ、対応する最低OSバージョン、インストールサイズ、アイコン、初回リリース日と最終更新日です。プロダクトマネージャー、グロースマーケター、投資家が、競合アプリのベンチマーク、リリース頻度の追跡、新バージョンがユーザーにどう受け止められているかの把握に利用しています。

app_idはAppleの数値IDで、App Storeのリンクにあるidの後ろの数字です。リンク全体を指定することもできます。掲載情報はストアフロントごとに異なるため、countryに対象のストアを指定してください。デフォルトは米国のストアです。大型アップデートの後は、通算のratingよりもcurrent_version_ratingのほうが現在のアプリの状態を正確に反映します。priceは数値で、通貨コードはcurrencyに入ります。formatted_priceはストアに表示されるテキストです。file_size_bytesの単位はバイトです。rating_countがnullの場合はAppleが件数を公開していないことを意味し、評価が0件であることとは異なります。

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

AIプロンプト

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

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにapp_store、actionにprofileを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - app_id: Appleの数値のアプリIDを指定します（例：アプリのリンクでidの後に続く数字）。App StoreアプリのURL全体を渡すこともでき、その場合はプラットフォームが数値IDを抽出します。com.example.app形式のBundle IDは渡さないでください。
- 任意パラメータ：
  - country: search、profile、reviewsで使用するApp Storeのストアフロントを、us、cn、jpなどの小文字2文字の国コードで選択します。デフォルトはusです。変わるのは照会するストアフロントで、アカウントの地域やEveryInfraの課金は変わりません。
- 1つのオブジェクトを返します。主なフィールド: 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": "profile",
  "params": {
    "app_id": "389801252"
  }
}
- 料金：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`	はい	`profile`	機能の識別子です。値は固定です。
`app_id`	body.params	`string`	はい	-	Appleの数値のアプリIDを指定します（例：アプリのリンクでidの後に続く数字）。App StoreアプリのURL全体を渡すこともでき、その場合はプラットフォームが数値IDを抽出します。com.example.app形式のBundle IDは渡さないでください。
`country`	body.params	`string`	いいえ	-	search、profile、reviewsで使用するApp Storeのストアフロントを、us、cn、jpなどの小文字2文字の国コードで選択します。デフォルトはusです。変わるのは照会するストアフロントで、アカウントの地域やEveryInfraの課金は変わりません。

コードサンプル

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": "profile",
  "params": {
    "app_id": "389801252"
  }
}'

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

レスポンス例

実際のレスポンス

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

json

{
  "id": "req_…",
  "platform": "app_store",
  "action": "profile",
  "results": {
    "app_id": 389801252,
    "name": "Instagram",
    "url": "https://apps.apple.com/us/app/instagram/id389801252?uo=4",
    "bundle_id": "com.burbn.instagram",
    "developer": "Instagram, Inc.",
    "developer_url": "https://apps.apple.com/us/developer/instagram-inc/id389801255?uo=4",
    "description": "Little moments lead to big friendships. Share yours on Instagram. \n— From Meta\n\nConnect with friends, find other fans, and see what people around you are up to and into. Explore your interests and post what's going on, from your daily moments to life's highlights.\n\nShare what you…",
    "release_notes": "Performance optimizations and stability improvements for a smoother, more reliable experience.",
    "version": "448.0.0",
    "price": 0,
    "currency": "USD",
    "formatted_price": "Free",
    "rating": 4.69,
    "rating_count": 29523309,
    "current_version_rating_count": 29523309,
    "content_rating": "12+",
    "category": "Photo & Video",
    "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/f5/7f/2c/f57f2c00-2dff-4704-501b-ab6849c6277d/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
    "min_os": "16.3",
    "file_size_bytes": 611172352,
    "released_at": "2010-10-06T08:12:41+00:00",
    "updated_at": "2026-09-21T15:59:55+00:00",
    "platform": "app_store",
    "genres": [
      "Photo & Video",
      "Social Networking"
    ],
    "languages": [
      "BN",
      "HR",
      "CS"
    ],
    "screenshot_urls": [
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/50/e2/8b/50e28b44-daa5-7101-6fb6-2d0e10fc72f3/1_iOS_5.5.jpg/392x696bb.jpg",
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/4d/a5/33/4da53369-3dce-b9b4-2a0c-1c6957dd40c4/1_iOS_5.5.jpg/392x696bb.jpg",
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/10/38/e1/1038e1c7-751f-c4ea-39b9-d9f4d08fc08d/2_iOS_5.5.jpg/392x696bb.jpg"
    ],
    "rating_scale": 5
  },
  "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`	プラットフォーム上の意味のまま

FAQ

`app_id`はどこで確認できますか？

アプリのApp Storeページで確認できます。リンク内のidの後ろの数字がapp_idで、たとえばid389801252で終わるリンクなら389801252です。リンク全体を渡すこともでき、その場合はIDが抽出されます。com.example.appのようなバンドルIDではアプリを特定できません。バンドルIDはbundle_idで返されます。「App Store検索」の結果にもapp_idが含まれます。

国によって詳細が異なるのはなぜですか？

App Storeのストアフロントはそれぞれ独立しています。countryにus、cn、jpなどの小文字のコードを指定してストアフロントを選ぶと、そのストアから詳細を取得します。あるストアフロントには掲載されていても別のストアフロントには掲載されていないことがあり、価格や評価もストアによって異なる場合があるため、比較する数値にはそれぞれストアフロントを記録してください。

`rating`と`current_version_rating`のどちらを使うべきですか？

ratingとrating_countは全バージョンを通した数値で、current_version_ratingとcurrent_version_rating_countは現在ストアに公開されているバージョンのみを対象とします。デザインの刷新や多数報告されていた不具合の修正の後は、現在のバージョンの数値のほうが今のアプリの評価をよく表します。新しいバージョンはまだ評価数が少ない場合があるため、まず件数を確認してください。

エラーと課金

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

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

Apple：App Store Connectのアプリ情報 ↗
Appleでは、アプリのApple IDとBundle IDを別々に定義しています。Apple IDはApp StoreのアプリURLにも使われます。
確認日：2026-09-04