Apple App Store API
既知のストアURLから、公開Apple App Storeのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。
利用できるApple App Store API
既知の掲載ページにはApp Detail、公開ランキングのURLにはRankings、既知のアプリURLからの公開フィードバックにはApp Reviewsを使用します。
取得できるApple App Storeデータ
現在のエンドポイントは、公開掲載情報のフィールドを共通のアプリ結果スキーマで保持し、取得できない値は空のままにします。
アプリの基本情報
取得可能なアプリID、名称、デベロッパー、カテゴリ、取得元URL、説明テキストを取得します。
表示中の掲載シグナル
取得可能な評価、レビュー数、価格、順位、公開日のコンテキストを、特定時点の値として保持します。
メディアと観測日時
取得可能な掲載メディアを collected_at とともに保存し、各レコードが観測時点のコンテキストを保持できるようにします。
Apple App Store APIの仕様概要
各エンドポイントは既知の公開URLを使用し、標準の非同期タスク結果リーダーで結果を取得します。
| エンドポイント | 入力 | 取得元の範囲 |
|---|---|---|
| App Detail | 1つ以上の製品ページURL | 送信したURLごとに正規化されたアプリのレコード最大1件 |
| Rankings | カテゴリまたはランキングのURLと、任意の results_limit | 送信したランキングに掲載されているアプリ |
| App Reviews | アプリURLと、任意の results_limit | 送信したアプリの公開レビュー |
Apple App Store APIの仕組み
3つのエンドポイントはすべて、標準の非同期タスクワークフローを使用します。
1. 既知の掲載ページURLを送信
対応するエンドポイントを選び、必須の urls 配列と任意の取得件数上限をPOSTして、task_id を保存します。
2. タスクを追跡
タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
3. 保存済みのレコードを読み取る
data.results.items を読み取り、has_more が true の間だけ next_cursor をたどります。
SocQのAPIキーで認証し、既知のApple App Storeの製品ページURLを1つ以上送信します。
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.itemsApple App Store APIの主なユースケース
カタログの情報補完
既知のアプリのレコードに、正規化された基本情報、説明のメタデータ、デベロッパー、カテゴリ、価格、メディア、取得元のコンテキストを追加します。
掲載情報の比較
用意したURLセット全体で、取得可能なメタデータ、表示中の評価、レビュー数、価格を比較します。
スナップショットのモニタリング
繰り返し取得した結果を collected_at とともに保存し、公開掲載フィールドの推移を比較します。
制限事項と公開データポリシー
Apple App Storeの結果は特定時点の公開掲載レコードであり、公開やアカウント管理の機能は提供しません。
- 送信するすべてのURLは、apps.apple.com またはそのサブドメインのいずれかに解決される必要があります。
- これらのAPIは、キーワードやバンドルIDのみではなく、既知のストアURLを受け付けます。
- App DetailはURLごとに最大1件の結果を保存します。RankingsとApp Reviewsは、タスク全体で1〜2,000の results_limit を受け付けます。
- タスク結果のカーソルは、SocQがすでに保存したレコードのページ送りにのみ使われます。
- 最終的な請求は保存された結果1件あたり0.15クレジットで、基本料金は0クレジットです。見積もりの方法は選択したエンドポイントによって異なります。
Apple App Store APIに関するよくある質問
Apple App Store APIとは何ですか?
Apple App Store APIは、既知のストアURLから、アプリの詳細、カテゴリランキング、公開アプリレビューを取得するAPIです。
キーワードでアプリを検索できますか?
いいえ。現在のリクエストは、既知のApple App Storeの製品ページURLまたはランキングURLの空でない配列を起点とします。
取得元のページネーションに対応していますか?
呼び出し側で使える取得元のカーソルはありません。タスク結果のカーソルは、取得後にすでに保存されたレコードのページ分割にのみ使われます。
データ取得の請求はどのように行われますか?
保存された結果は1件あたり0.15クレジットです。最終的な料金は実際の結果件数に基づき、見積もりの方法は選択したエンドポイントによって異なります。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
SEO API
Googleのオーガニック検索結果をリアルタイムで取得し、キーワードの需要と順位獲得の難易度を比較し、シードキーワードを拡張し、サイトの検索での可視性を支えるキーワードとページを明らかにし、検索意図を分類できるほか、Googleニュース・画像・サジェスト、Bing、YouTubeの結果も集められます。すべてのエンドポイントで、共通のSocQのAPIキー、非同期タスクフロー、正規化された結果形式を使用します。
Telegram API
t.meリンクから公開Telegramチャンネルを読み取ります。登録者数付きのチャンネル情報、閲覧数とリアクション付きの投稿、個別の投稿、ディスカッショングループのコメント、類似チャンネル、全履歴の検索に対応します。
Link in Bio API
クリエイターがInstagram、TikTok、YouTubeのプロフィール欄に置く1本のリンクを、表示名、紹介文、アイコン、掲載されている連絡先メール、連携SNS、各ボタンのタイトルとリンク先という構造化データに変えます。
Creator API
Instagram、TikTok、YouTube、X、Facebook、Threadsのプロフィール1件を起点に、クリエイターの公開ビジネスメール、ほかのSNSのアカウント、プロフィール写真からの年齢・性別の推定を取得します。
Google Hotels API
目的地でホテルを検索し、任意のホテルのGoogleホテル上のプロフィールと1泊料金カレンダーを取得します。3つはすべて同じホテルIDでつながります。
Brand Monitoring API
ブランド、製品、トピックに言及したWebページを探し、ページごとに感情をスコア化し、Web全体での語られ方を要約します。


