Instagram Posts
Instagram投稿は、キャプション、投稿者情報、画像または動画、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメントを含むフィード上のコンテンツです。これらのコンテンツシグナルは、クリエイター調査、キャンペーンの振り返り、メディア分析、過去データのレポーティングに活用できます。
Instagram Posts API の主な機能
- ユーザー名による投稿収集1つ以上のユーザー名の公開Instagram投稿を、正規化された1つのレスポンス形式で収集します。
- メディアの参照情報とサイズ公開メディアとサムネイルの参照情報、サイズ、動画の長さを、正規化された media フィールドで返します。
- 写真・動画のレコード公開されている写真投稿と動画投稿を、同じレスポンス構造に正規化します。
- コンテンツとエンゲージメントのフィールド各投稿レコードに、キャプション、投稿者情報、投稿日時、表示中の指標、ハッシュタグ、メンションを含めます。
- 公開データの範囲非公開、削除済み、制限付き、ログインが必要なコンテンツはレスポンスの対象外です。
Instagram Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | @ を付けない公開Instagramユーザー名です。カンマまたは改行で区切って指定します。 |
results_limit | 任意 | 収集タスクがリクエストするレコードの最大件数です。正の整数で指定してください。 |
Instagram Posts API の使い方
公開ユーザー名を非同期タスクとして送信し、タスクIDをポーリングして、正規化された投稿レコードをカーソルページネーションで読み取ります。
- @ を付けない1つ以上の公開Instagramユーザー名を用意します。
- usernames と任意の results_limit を /v1/instagram/posts に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /v1/tasks/{task_id}?limit=50 を読み取り、さらにレコードがある場合は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["natgeo"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Instagram Posts API の主なユースケース
- プロフィールの投稿収集: 選んだInstagramユーザー名の公開投稿を、メディアの参照情報と固定IDを備えた正規化レコードとして収集します。
- コンテンツ調査: 調査チームや分析チームが確認する投稿について、公開キャプション、タイムスタンプ、ハッシュタグ、表示中のエンゲージメント数を収集します。
- アーカイブワークフロー: 公開投稿のメタデータ、メディアの参照情報、投稿者情報、ソースURL、収集日時を、レビューキュー、レポーティングシステム、社内記録に保存します。
- キャンペーンの品質確認: クリエイターやブランドのユーザー名で返された公開投稿を確認してから、選んだレコードをキャンペーンデータと結合します。
- プロフィールのコンテンツ情報補完: 投稿ID、投稿者情報、キャプション、メディアの参照情報、表示中の指標を、既存のプロフィールやキャンペーンのレコードと結合します。
Instagram Posts API 活用のヒント
- ユーザー名は先頭の @ を付けずに送信し、新しいワークフローを検証している間はバッチを小さく保ってください。
- ソース側の状況によっては、一部の公開レコードでメディアの参照情報、カウンター、タイムスタンプが欠けることがあります。
- 429、チャレンジ、一時的なブロックのレスポンスに対しては、積極的にリトライするのではなく、控えめなリトライとバックオフを適用してください。
- プロフィール単位のリール収集には Reels API、アカウントの発見には Search API、公開コメントスレッドが重要な場合は Comments API を使用してください。
- 非公開アカウント、ストーリーズ、ハイライト、ログインが必要なフィールドを前提にしたワークフローは設計しないでください。
関連API
Instagram Posts API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。
- Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
- Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
- Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
- Instagram Tagged Posts API — 指定したプロフィールがタグ付けされた公開投稿を、投稿者、メディア、メンション、タグ付けされたユーザーの情報、エンゲージメントとともに取得します。
- Instagram Transcript API — 公開投稿またはリールのURLから、文字起こしテキスト、言語、形式、元のURL、ショートコードを抽出します。
- Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API