apple-app-store/
app-detail

既知のapps.apple.comのURLから公開Apple App Storeの掲載ページを取得し、アプリ情報、説明文、開発者情報、評価、価格、メディアを正規化レコードとして返します。

Apple App Store App Detail API

既知の掲載ページURL
正規化アプリレコード
公開製品ページのメタデータ
結果1件あたり0.15クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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を送信して非同期タスクを追跡し、保存された結果ページから正規化アプリレコードを読み取ります。

  1. ホスト名がapps.apple.comまたはそのサブドメインである、公開Apple App Storeの製品ページURLを1つ以上用意します。
  2. urls 配列を /v1/apple-app-store/app-detail に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

Apple 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タスクにすでに保存されている結果を順に読み進めるためだけのものです。

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から公開カテゴリランキングの項目を取得し、元の順位、アプリ情報、デベロッパー、評価、レビュー数、価格、メディアの各フィールドを返します。

他のプラットフォームを見る

Apple App Storeのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Apple App Store App Detail API — よくある質問

Apple App Store App Detail APIは、既知のApple App Store製品ページURLから公開メタデータを取得するためのプログラムインターフェースです。正規化されたアプリ識別情報、説明文、開発者とカテゴリの情報、表示中の評価、価格、メディア、取得日時を返します。

解析後のホスト名がapps.apple.comまたはそのサブドメインである製品ページを含む、空でない urls 配列を送信してください。このエンドポイントでは、キーワード、バンドルID、国コード、results_limit フィールドは使用できません。

正規化レコードには、アプリID、名前、説明文、開発者、カテゴリ、評価、レビュー数、インストール数、構造化された価格、順位、メディア、ソースURL、公開日時、取得日時が含まれる場合があります。公開掲載ページにないフィールドは null のままとなり、表示画面では省略してください。

対応していません。プロバイダーは送信されたURLごとに1行の入力を受け取り、タスクはURLごとに最大1件の正規化レコードを保持します。next_cursor と has_more は、保存されたSocQの結果を読み取るためだけのものです。

リクエスト時の見積もりは、送信したURLの数に対し、想定される結果1件あたり0.15クレジットで計算されます。最終的な請求は正常に保存された正規化結果の件数に基づき、結果が空のタスクは0クレジットの基本料金で確定します。