Apple App Store App Detail
Apple App Storeの掲載ページは、アプリの識別情報、説明文、開発者とカテゴリの情報、表示中の評価、価格、メディアを含む公開製品ページです。これらのフィールドは、カタログ情報の補完、掲載ページの比較、特定時点のメタデータのモニタリングに活用できます。
Apple App Store App Detail API の主な機能
- 既知URLの一括入力1つ以上のapps.apple.comの製品ページURLを送信できます。整形された各URLは1件のプロバイダー入力に対応し、送信したURLごとに最大1件の正規化アプリレコードが保持されます。
- 掲載ページの識別情報と説明メタデータアプリID、名前、説明文、開発者、カテゴリ、ソースURL、取得日時を統一されたアプリスキーマで返します。
- 表示中の評価と価格情報取得可能な評価、レビュー数、構造化された価格フィールドを保持するため、製品ページのテキストを解析せずに掲載ページのレコードを比較できます。
- メディアとカタログ情報取得可能な掲載メディアを公開日時・取得日時のタイムスタンプとともに保持し、公開ページに表示されないスキーマ値は省略します。
Apple App Store App Detail API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。既知の製品ページURLを1つ以上含む配列です。空でない各要素はapps.apple.comまたはそのサブドメインに解決される必要があります。このエンドポイントではキーワード、バンドルID、国の入力は使用できません。 |
Apple App Store App Detail API の使い方
既知の掲載ページURLを送信して非同期タスクを追跡し、保存された結果ページから正規化アプリレコードを読み取ります。
- ホスト名がapps.apple.comまたはそのサブドメインである、公開Apple App Storeの製品ページURLを1つ以上用意します。
- urls 配列を /v1/apple-app-store/app-detail に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items からアプリレコードを読み取り、has_more が true の場合に限り next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is trueApple App Store App Detail API の主なユースケース
- アプリカタログの情報補完: 既知のApp Storeリンクをすでに持つレコードに、正規化されたアプリ識別情報、説明メタデータ、開発者、カテゴリ、価格、メディア、ソースURLを追加します。
- 掲載ページの比較: 選択したURLセット全体で、開発者とカテゴリの情報、表示中の評価、レビュー数、価格、説明文を比較します。
- メタデータのスナップショット監視: 繰り返し取得した結果を collected_at とともに保存し、名前、説明文、カテゴリ、表示中の評価、価格、メディアの経時的な変化を把握します。
Apple App Store App Detail API 活用のヒント
- 解析した各ホスト名がapps.apple.comであることを確認し、検索語、バンドルID、ストア名ではなく製品ページURLを送信してください。
- 送信前に重複したURLを取り除き、同じ入力によって冗長なプロバイダー行や重複したアプリレコードが作成されないようにしてください。
- 掲載ページによってはアプリスキーマの一部しか公開されないため、rating、reviews_count、price、media、published_at、installs、rank は null になり得るものとして扱ってください。
- next_cursor をApp Store側のページトークンとして扱わないでください。これは完了したSocQタスクにすでに保存されている結果を順に読み進めるためだけのものです。
関連API
Apple App Store App Detail API 以外に別の種類の公開Apple App Storeデータが必要な場合は、これらのAPIをご利用ください。
- Apple App Store App Reviews API — 既知のapps.apple.com URLから公開アプリレビューを取得し、正規化された本文、評価、レビュー投稿者の詳細、タイムスタンプ、アプリの参照を返します。
- Apple App Store Rankings API — 対応するApple App StoreのURLから公開カテゴリランキングの項目を取得し、元の順位、アプリ情報、デベロッパー、評価、レビュー数、価格、メディアの各フィールドを返します。