API一覧に戻る
Instagramの公開データ

Instagram公開データAPI

公開プロフィールを検索・照会し、フォロワーリストのレコード、フォロー関係、投稿、プロフィールがタグ付けされた投稿、ハッシュタグの検索結果、リール、文字起こし、コメント、アカウント数値、エンゲージメント指標、メディアのメタデータを、1つの非同期ワークフローで取得できます。

利用できるInstagram API

既知プロフィールの照会、プロフィール検索、フォロワーリストの取得、フォロー関係の取得、アカウント指標、投稿、プロフィールがタグ付けされた投稿、ハッシュタグ検索、リール、文字起こし、コメントなど、目的に合ったエンドポイントを選べます。すべてのエンドポイントで、共通のSocQ認証とタスク結果の取得方式を使用します。

instagram/posts

投稿結果1件あたり0.34クレジット

instagram/post-info

投稿結果1件あたり0.5クレジット

instagram/hashtag-posts

検索結果1件あたり0.5クレジット

instagram/reels-search

検索結果1件あたり0.5クレジット

instagram/story-highlights

投稿結果1件あたり0.5クレジット

instagram/tagged-posts

投稿結果1件あたり0.5クレジット

instagram/transcript

投稿結果1件あたり0.7クレジット

instagram/audio-reels

投稿結果1件あたり0.5クレジット

instagram/comments

コメント結果1件あたり0.3クレジット

instagram/followers-count

プロフィール結果1件あたり0.52クレジット

instagram/profiles

プロフィール結果1件あたり0.6クレジット

instagram/followers-list

プロフィール結果1件あたり0.3クレジット

instagram/following-list

プロフィール結果1件あたり0.3クレジット

instagram/reels

投稿結果1件あたり0.52クレジット

instagram/search

検索結果1件あたり0.54クレジット

instagram/highlight-items

投稿結果1件あたり0.5クレジット

instagram/trending-reels

投稿結果1件あたり0.5クレジット

instagram/stories

投稿結果1件あたり0.5クレジット

instagram/similar-users

プロフィール結果1件あたり0.5クレジット

instagram/comment-replies

コメント結果1件あたり0.3クレジット

instagram/post-likers

プロフィール結果1件あたり0.3クレジット

instagram/location-info

検索1リクエストあたり0.5クレジット

instagram/location-posts

投稿結果1件あたり0.5クレジット

instagram/location-search

検索1リクエストあたり0.5クレジット

instagram/search-hashtags

検索結果1件あたり0.5クレジット

instagram/user-about

プロフィール1リクエストあたり0.5クレジット

取得できるInstagramデータ

SocQは公開Instagramの結果を安定したJSONレコードに正規化するため、プロダクトチームがブラウザ自動化やレスポンス整形のパイプラインを個別に保守する必要はありません。

プロフィールと検索

既知のユーザー名を照会したり公開アカウントを検索したりして、ユーザー名、表示名、プロフィール文、プロフィールURL、プロフィール画像、認証状態、表示中のアカウント情報を返します。

フォロワー数とアカウント数値

公開ユーザー名またはプロフィールURLから、表示中のフォロワー数・フォロー数・投稿数を取得します。

公開フォロワーリストのレコード

取得元のユーザー名ごとに、表示中のフォロワープロフィールを取得します。正規化されたアカウント情報、プロフィール画像、公開状態のフラグ、関係のコンテキスト、取得時の表示位置、取得日時を含みます。

公開フォロー関係

1つ以上の取得元アカウントがフォローしている公開プロフィールを取得します。アカウント情報、公開状態、取得元、関係、表示位置、取得可能なアカウント数値のコンテキストを含みます。

投稿とタグ付け投稿

指定したユーザー名が公開した投稿や、指定したプロフィールがタグ付けされた投稿を取得します。キャプション、投稿者、メディア、タグのコンテキスト、タイムスタンプ、表示中のエンゲージメントを含みます。

ハッシュタグによる投稿検索

1つ以上のハッシュタグに一致する公開投稿を検索します。期間やリールの絞り込み(任意)に対応し、一致したハッシュタグのコンテキストも返します。

公開リール

リールのキャプション、メディア参照、再生数とエンゲージメント数、再生時間、ハッシュタグ、メンション、取得可能な場合は音源のメタデータを取得します。

投稿とリールの文字起こし

公開投稿やリールのURLから、文字起こしテキスト、言語、形式、取得元のコンテキストを抽出します。音声のないメディアではレコードが返らない場合があります。

公開コメント

公開Instagram投稿のURLから、コメント本文、投稿者フィールド、タイムスタンプ、投稿の参照、表示中のいいね数や返信数を取得します。

SocQ vs Instagram Graph API

2つのプロダクトは、異なる連携の課題を解決するものです。SocQは正規化された公開データの取得を目的に設計されています。一方、Metaの公式APIは主に、承認済みのプロアカウントの管理やプラットフォーム上の操作を目的としています。

機能SocQInstagram Graph API
主な用途公開プロフィール、フォロワーリスト、フォロー関係、コンテンツ、コメントのデータ取得承認済みのビジネスアカウント・クリエイターアカウントの管理
顧客側のOAuthSocQのAPIキーのみ。顧客のInstagram OAuthは不要Metaアプリの設定とアカウントの認可
投稿の公開非対応対象のプロアカウントで対応
非公開コンテンツ非対応認可された権限で許可されたデータのみ
レスポンス形式SocQの全エンドポイントで正規化Meta Graph独自のレスポンス形式

Instagram APIの仕組み

すべてのInstagramエンドポイントは共通の非同期ワークフローに従うため、時間のかかるデータ取得をリクエストスレッドの外で処理できます。

  1. 1. タスクを送信

    検索クエリ、ユーザー名、ハッシュタグ、または公開プロフィールやコンテンツのURLと、任意の取得件数上限を指定してPOSTリクエストを送信します。

  2. 2. タスクのステータスをポーリング

    返されたタスクIDを使い、タスクが成功または失敗するまでポーリングします。短い間隔でリトライを繰り返さず、バックオフを適用してください。

  3. 3. 正規化された結果を読み取る

    結果アイテムを取得して固定IDを保存し、さらにレコードがある場合は next_cursor をたどります。

1回のAPIリクエストから始める

SocQのAPIキーで認証します。この例では公開Instagramプロフィールの検索を開始します。既知プロフィールの照会、フォロワーリスト、フォロー関係、投稿やタグ付け投稿、ハッシュタグ検索、リール、文字起こし、コメント、アカウント数値も、同じタスクワークフローで利用できます。

curl -X POST "https://api.socq.ai/v1/instagram/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable travel","results_limit":25}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Instagram APIの主なユースケース

クリエイターの発掘

関連する公開プロフィールを見つけ、選んだアカウントに投稿、リール、表示中のフォロワー指標を追加します。

フォロワーリストの調査

公開されているフォロワープロフィールをサンプリングし、選んだ取得元アカウント間の重複を比較して、選定したユーザー名をプロフィール情報の補完キューに追加します。

コンテンツのモニタリング

キャンペーン、競合、クリエイター、定期的なコンテンツ形式を対象に、投稿、指定プロフィールがタグ付けされた投稿、ハッシュタグの結果、リール、文字起こしのレコード、選んだ公開コメントを追跡します。

分析データの補完

社内のダッシュボード、データウェアハウス、レポーティングシステムに、表示中のソーシャルアカウント情報やエンゲージメントのフィールドを追加します。

調査用ディレクトリ

固定URL、ID、取得日時を含む、確認しやすい公開アカウントとコンテンツのデータセットを構築します。

制限事項と公開データポリシー

SocQの対象は、公開されているInstagramの結果に限られます。アカウント、コンテンツ、公開ソースのレスポンスが変わると、取得できる内容も変わる場合があります。

  • 非公開、制限付き、削除済み、ログインが必要なコンテンツはサポート対象外です。
  • フォロワーリストの結果は公開データのサンプルであり、完全なエクスポートを保証するものではありません。また、同じプロフィールが複数の取得元アカウントの結果に含まれる場合があります。
  • 一部の公開レコードでは、カウンター、コメントのフィールド、メディア参照、プロフィール文、音源のフィールドが欠ける場合があります。
  • リクエストレートは控えめに設定し、カーソルページネーションを使い、レート制限に近いレスポンスを受けた後はバックオフしてください。
  • このAPIでInstagramのコンテンツを公開、編集、削除することはできません。

Instagram APIに関するよくある質問

これは公式のInstagram Graph APIですか?

いいえ。SocQは、対応している公開Instagramの結果に正規化された形でアクセスできるサービスです。承認済みアカウントの管理や投稿の公開が必要な場合は、MetaのGraph APIを利用してください。

ユーザーがInstagramアカウントを連携する必要はありますか?

いいえ。対応している公開データのエンドポイントでは、顧客側のInstagram OAuthは不要です。リクエストにはSocQのAPIキーを使用します。

非公開プロフィールにアクセスできますか?

いいえ。非公開、制限付き、ログインが必要なInstagramコンテンツには対応していません。

料金はどのように計算されますか?

各エンドポイントに、現在の結果1件あたりのクレジット料金が表示されています。請求は、タスクが返した正規化結果レコードの件数に基づきます。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

TikTok API

対応する公開TikTokプロフィール、個別動画のメタデータ、トップレベルコメント、動画の検索結果、指定したハッシュタグの動画を、正規化された1つの非同期ワークフローで取得できます。

YouTube API

対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。

Facebook API

公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。

X API

公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。

LinkedIn API

既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。

Reddit API

既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。