プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
App Storeの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | アプリ名またはカテゴリでApp Storeを検索します。各アプリのID、バンドルID、デベロッパ、バージョン、価格、評価、リリース日を取得できます。ストアの国はcountryで選択します（デフォルトはUS）。ダウンロード数、収益、キーワード順位の履歴は含まれません。 | 1,000リクエストあたり$1.39 | 正常 |
アプリ詳細profile | 数値のapp_idを指定して、1つのアプリのApp Store掲載情報を取得します。デベロッパ、バンドルID、バージョン、リリースノート、価格、年齢区分、現行バージョンの評価が含まれます。App Storeのアプリページの完全なURLも使用できますが、バンドルIDは使用できません。このレコードは現在公開中の掲載情報を示すもので、App Store Connectのデータや過去のバージョンの情報は含まれません。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | アプリのApp Storeユーザーレビューを取得します。タイトル、本文、星評価、投稿者、アプリのバージョン、「役に立った」の投票数、日付が含まれます。並べ替えはnewest（デフォルト）またはmost_helpfulから選び、ストアの国はcountryで選択します。 | 1,000リクエストあたり$1.39 | 正常 |
アプリのキーワードランキングkeywords_for_app | 数値のapp_idを指定して、1つのアプリがランクインしているApp Storeの検索キーワードを一覧表示します。各キーワードには、検索ボリューム、検索結果でのアプリの順位、その検索で返されるアプリ数、数値の最終更新日時が含まれ、アプリの評価と価格も併せて返されます。対象はUSストアのみです。デフォルトは20キーワードで、最大100件まで取得できます。 | 1,000リクエストあたり$11.51 | 正常 |
メトリクス一括取得bulk_metrics | app_idsに数値IDを指定して、最大20件のApp Storeアプリのキーワードランキング集計を一度に取得します。各行には、アプリのkeyword_count、そのうち1位、トップ3、トップ10に入っているキーワード数、それらのキーワードの検索ボリュームを示すkeywords_search_volumeが含まれます。対象はUSストアのみで、キーワードデータがないアプリの行は返されません。 | 1,000リクエストあたり$11.51 | 正常 |
競合competitors | 数値のapp_idを指定して、1つのアプリと同じ検索キーワードでランクインしているApp Storeアプリを検索します。各競合アプリについて、共通キーワード数、それらのキーワードでの平均順位、そのうちトップ10に入っている数、合計検索ボリュームが、競合アプリ自身のキーワード集計と併せて表示されます。対象はUSストアのみで、各行にはアプリ名ではなくアプリIDが含まれます。デフォルトは20件で、最大100件の競合アプリを取得できます。 | 1,000リクエストあたり$11.51 | 正常 |
共通キーワードkeyword_intersection | app_idsに数値IDを指定して、2〜10件のアプリすべてがランクインしているApp Storeの検索キーワードを確認します。各行は共通のkeyword 1件で、検索ボリューム、その検索で返されるアプリ数、rankingsに各アプリの順位とタイトルが含まれます。対象はUSストアのみです。デフォルトは20キーワードで、最大100件まで取得できます。 | 1,000リクエストあたり$11.51 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
App Storeの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 アプリ名またはカテゴリでApp Storeを検索します。各アプリのID、バンドルID、デベロッパ、バージョン、価格、評価、リリース日を取得できます。ストアの国は | keyword | country | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform · genres · languages · screenshot_urls |
profileアプリ詳細 数値の | app_id | country | Sync配信 | — | 1,000リクエストあたり$1.39 | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform · genres · languages · screenshot_urls |
reviewsレビュー アプリのApp Storeユーザーレビューを取得します。タイトル、本文、星評価、投稿者、アプリのバージョン、「役に立った」の投票数、日付が含まれます。並べ替えは | app_id | country, sort | Sync配信 | カタログ値：defaultLimit=30、maxLimit=500。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · title · text · rating · rating_scale · author · app_version · helpful_count · posted_at · app_id · app_name · platform |
keywords_for_appアプリのキーワードランキング 数値の | app_id | country | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、100が上限として適用されます。 | 1,000リクエストあたり$11.51 | keyword · search_volume · search_rank · search_result_count · ranked_at · app_id · title · url · icon_url · developer · rating · rating_scale · rating_count · is_free · price · currency · total_keywords · platform |
bulk_metricsメトリクス一括取得
| app_ids | country | Sync配信 | — | 1,000リクエストあたり$11.51 | app_id · keyword_count · top1_keywords · top3_keywords · top10_keywords · keywords_search_volume · platform |
competitors競合 数値の | app_id | country | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、100が上限として適用されます。 | 1,000リクエストあたり$11.51 | app_id · shared_keywords · avg_position · shared_top10_keywords · shared_search_volume · keyword_count · top10_keywords · target_app_id · platform |
keyword_intersection共通キーワード
| app_ids | country | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、100が上限として適用されます。 | 1,000リクエストあたり$11.51 | keyword · search_volume · search_result_count · ranked_at · rankings · total_keywords · platform |
App Storeのsearchのパラメータはそれぞれどういう意味ですか？
アプリ名またはカテゴリでApp Storeを検索します。各アプリのID、バンドルID、デベロッパ、バージョン、価格、評価、リリース日を取得できます。ストアの国はcountryで選択します（デフォルトはUS）。ダウンロード数、収益、キーワード順位の履歴は含まれません。
keyword必須- App Storeの検索語句（例：habit trackerやアプリ名）を指定します。Bundle IDは指定しないでください。以降のアプリ詳細やレビューのリクエストには、検索結果で返される数値のapp_idを使用します。
country任意- search、profile、reviewsで使用するApp Storeのストアフロントを、us、cn、jpなどの小文字2文字の国コードで選択します。デフォルトはusです。変わるのは照会するストアフロントで、アカウントの地域やEveryInfraの課金は変わりません。
App Storeのprofileのパラメータはそれぞれどういう意味ですか？
数値のapp_idを指定して、1つのアプリのApp Store掲載情報を取得します。デベロッパ、バンドルID、バージョン、リリースノート、価格、年齢区分、現行バージョンの評価が含まれます。App Storeのアプリページの完全なURLも使用できますが、バンドルIDは使用できません。このレコードは現在公開中の掲載情報を示すもので、App Store Connectのデータや過去のバージョンの情報は含まれません。
app_id必須- Appleの数値のアプリIDを指定します（例：アプリのリンクでidの後に続く数字）。App StoreアプリのURL全体を渡すこともでき、その場合はプラットフォームが数値IDを抽出します。com.example.app形式のBundle IDは渡さないでください。Apple：App Store Connectのアプリ情報 — Appleでは、アプリのApple IDとBundle IDを別々に定義しています。Apple IDはApp StoreのアプリURLにも使われます。 · 確認日
country任意- search、profile、reviewsで使用するApp Storeのストアフロントを、us、cn、jpなどの小文字2文字の国コードで選択します。デフォルトはusです。変わるのは照会するストアフロントで、アカウントの地域やEveryInfraの課金は変わりません。
App Storeのreviewsのパラメータはそれぞれどういう意味ですか？
アプリのApp Storeユーザーレビューを取得します。タイトル、本文、星評価、投稿者、アプリのバージョン、「役に立った」の投票数、日付が含まれます。並べ替えはnewest（デフォルト）またはmost_helpfulから選び、ストアの国はcountryで選択します。
app_id必須- Appleの数値のアプリIDを指定します（例：アプリのリンクでidの後に続く数字）。App StoreアプリのURL全体を渡すこともでき、その場合はプラットフォームが数値IDを抽出します。com.example.app形式のBundle IDは渡さないでください。Apple：App Store Connectのアプリ情報 — Appleでは、アプリのApple IDとBundle IDを別々に定義しています。Apple IDはApp StoreのアプリURLにも使われます。 · 確認日
country任意- search、profile、reviewsで使用するApp Storeのストアフロントを、us、cn、jpなどの小文字2文字の国コードで選択します。デフォルトはusです。変わるのは照会するストアフロントで、アカウントの地域やEveryInfraの課金は変わりません。
sort任意- App Storeのレビューの表示順を指定します。新しいレビューを表示するnewest、または上位のレビューを表示するmost_helpfulを指定できます。省略した場合、reviewsアクションではnewestが使用されます。このパラメータはアプリの検索順位や星評価を絞り込むものではないため、searchやprofileのリクエストで結果を変更する目的では使用しないでください。指定可能な値:
most_helpfulnewest
App Storeのkeywords_for_appのパラメータはそれぞれどういう意味ですか？
数値のapp_idを指定して、1つのアプリがランクインしているApp Storeの検索キーワードを一覧表示します。各キーワードには、検索ボリューム、検索結果でのアプリの順位、その検索で返されるアプリ数、数値の最終更新日時が含まれ、アプリの評価と価格も併せて返されます。対象はUSストアのみです。デフォルトは20キーワードで、最大100件まで取得できます。
app_id必須- Appleの数値のアプリID（例：
324684580）、またはアプリのapps.apple.comリンクです。リンクの場合はidの後の数字が使われます。com.example.appのようなBundle IDは受け付けられず、呼び出しの実行前に拒否されます。 country任意keywords_for_appのストアフロントです。対応しているのは米国ストアのみです。省略するかusを指定してください。それ以外の国は呼び出しの実行前に拒否されます。
App Storeのbulk_metricsのパラメータはそれぞれどういう意味ですか？
app_idsに数値IDを指定して、最大20件のApp Storeアプリのキーワードランキング集計を一度に取得します。各行には、アプリのkeyword_count、そのうち1位、トップ3、トップ10に入っているキーワード数、それらのキーワードの検索ボリュームを示すkeywords_search_volumeが含まれます。対象はUSストアのみで、キーワードデータがないアプリの行は返されません。
app_ids必須bulk_metrics（1〜20個）またはkeyword_intersection（2〜10個）に渡すアプリで、配列またはカンマ区切りの文字列でAppleの数値IDを指定します。数値IDはアプリのリンクでidの後に続く数字です（例：324684580）。対象は米国ストアのみです。bulk_metricsではアプリごとに1件が返り、データのないアプリは除外されます。keyword_intersectionでは各件が、すべてのアプリが順位を得ているキーワード1つに対応します。それ以外の個数は、呼び出しの実行前に拒否されます。country任意bulk_metricsのストアフロントです。対応しているのは米国ストアのみです。省略するかusを指定してください。それ以外の国は呼び出しの実行前に拒否されます。
App Storeのcompetitorsのパラメータはそれぞれどういう意味ですか？
数値のapp_idを指定して、1つのアプリと同じ検索キーワードでランクインしているApp Storeアプリを検索します。各競合アプリについて、共通キーワード数、それらのキーワードでの平均順位、そのうちトップ10に入っている数、合計検索ボリュームが、競合アプリ自身のキーワード集計と併せて表示されます。対象はUSストアのみで、各行にはアプリ名ではなくアプリIDが含まれます。デフォルトは20件で、最大100件の競合アプリを取得できます。
app_id必須- Appleの数値のアプリIDを指定します（例：アプリのリンクでidの後に続く数字）。App StoreアプリのURL全体を渡すこともでき、その場合はプラットフォームが数値IDを抽出します。com.example.app形式のBundle IDは渡さないでください。
country任意competitorsのストアフロントです。対応しているのは米国ストアのみです。省略するかusを指定してください。それ以外の国は呼び出しの実行前に拒否されます。
App Storeのkeyword_intersectionのパラメータはそれぞれどういう意味ですか？
app_idsに数値IDを指定して、2〜10件のアプリすべてがランクインしているApp Storeの検索キーワードを確認します。各行は共通のkeyword 1件で、検索ボリューム、その検索で返されるアプリ数、rankingsに各アプリの順位とタイトルが含まれます。対象はUSストアのみです。デフォルトは20キーワードで、最大100件まで取得できます。
app_ids必須bulk_metrics（1〜20個）またはkeyword_intersection（2〜10個）に渡すアプリで、配列またはカンマ区切りの文字列でAppleの数値IDを指定します。数値IDはアプリのリンクでidの後に続く数字です（例：324684580）。対象は米国ストアのみです。bulk_metricsではアプリごとに1件が返り、データのないアプリは除外されます。keyword_intersectionでは各件が、すべてのアプリが順位を得ているキーワード1つに対応します。それ以外の個数は、呼び出しの実行前に拒否されます。country任意keyword_intersectionのストアフロントです。対応しているのは米国ストアのみです。省略するかusを指定してください。それ以外の国は呼び出しの実行前に拒否されます。
App Store APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"app_store","action":"search","params":{"keyword":"<keyword>"}}'
App Storeのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
レビューデータを有料プロダクトにする方法：App Storeのフィードバックからバージョン方針を決めるまで
スクレイピングしたレビューから、課金できるプロダクトをどう作ればよいのでしょうか。本記事では、アプリストアのレビュー分析を出発点に、感情スコアやワードクラウドを提供するだけにとどまらず、エビデンスカード、サポートチケット、バージョンレビュー、サービスの範囲、契約更新時の検証について解説します。
記事を読む統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むApp Store APIに関する質問
App Store APIでは何を取得できますか？
platformをapp_storeに設定します。現在のカタログには検索、アプリ詳細、レビュー、アプリのキーワードランキング、メトリクス一括取得、moreが掲載されています。これらのアクション名はそれぞれ異なるApp Storeのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
App Storeのsearchリクエストを開始するには、どの入力を使用しますか？
App Storeの検索語句（例：habit trackerやアプリ名）を指定します。Bundle IDは指定しないでください。以降のアプリ詳細やレビューのリクエストには、検索結果で返される数値のapp_idを使用します。params内のkeywordとして送信してください。
App Storeのsearchはどのフィールドを返しますか？
宣言されたスキーマにはapp_id、name、bundle_id、developerが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
App Storeのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。