Instagram Search
Instagramの検索結果は、名前、キーワード、トピックに一致した公開プロフィールで、ユーザー名、プロフィール文、プロフィール画像、認証・非公開の状態、表示中のアカウント指標を含みます。これらのレコードは、クリエイターの発掘、ブランド調査、オーディエンスの選別、プロフィール情報の補完に活用できます。
Instagram Search API の主な機能
- プロフィールのキーワード検索キーワード、ハンドル、名前、アカウントに関するフレーズで公開Instagramプロフィールを検索します。
- アカウント情報と数値各プロフィール結果について、ユーザー名、表示名、プロフィール文、プロフィールURL、アバター、認証・非公開の状態、表示中の数値フィールドを返します。
- 一貫したプロフィールスキーマ幅広いキーワード、名前、ハンドルの完全一致のいずれで検索しても、同じ形式の正規化プロフィールを返します。
- 取得件数の上限指定results_limit で、1回の検索でリクエストするプロフィールレコードの最大件数を設定できます。
- 公開データの範囲非公開、制限付き、削除済み、ログインが必要なプロフィールデータはレスポンスの対象外です。
Instagram Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 検索キーワード、ハンドル、またはプロフィールに関するフレーズです。 |
results_limit | 任意 | 収集タスクがリクエストするレコードの最大件数です。正の整数で指定してください。 |
Instagram Search API の使い方
プロフィール検索クエリを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたプロフィール結果をカーソルページネーションで読み取ります。
- 空でないプロフィールのキーワード、ハンドル、または検索フレーズを用意します。
- query と任意の results_limit を /v1/instagram/search に 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/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}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Instagram Search API の主なユースケース
- クリエイターの発掘: 詳細な情報補完の前に、キーワード、ハンドル、カテゴリ、キャンペーンのフレーズに関連する公開プロフィールを見つけます。
- アカウント情報の補完: 選んだ検索結果について、公開プロフィールのアカウント情報、プロフィール文、認証・非公開の状態、表示中の数値フィールドを取得します。
- ブランドの発見: 名前、商品カテゴリ、市場に関するフレーズに関連する、ブランドや組織の公開プロフィールを見つけます。
- 調査用リストの作成: 調査、アプローチ先の選定、社内分析のために、確認可能な公開Instagramプロフィールのリストを作成します。
- プロフィール選定ワークフロー: 関連するプロフィールを選んだうえで、Posts、Reels、Followers Count の各APIを呼び出し、より詳しい公開レコードを取得します。
Instagram Search API 活用のヒント
- 検索ワークフローでは 429 レスポンスを通常の負荷シグナルとして扱い、積極的にリトライするのではなく、バックオフと取得件数の縮小で対応してください。
- 検索を再実行・監査できるよう、タスクID、固定のプロフィールID、ユーザー名、正規URLを保存してください。
- 検索結果はプロフィールの発見に使い、より詳しいレコードが必要な場合は Posts、Reels、Followers Count の各APIを呼び出してください。
- 公開されているAPIドキュメントで明示的にサポートされていない限り、非公開データ、ログインが必要なデータ、アカウント所有者のみが見られるデータを連携の前提に含めないでください。
- ユーザーが入力した検索語は、本番パイプラインに送る前にサニタイズしてください。
関連API
Instagram Search API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。
- Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
- Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
- Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
- Instagram Hashtag Posts API — ハッシュタグで公開投稿を探し、元のタグ情報、メディア、クリエイター、タイムスタンプ、表示中のエンゲージメントを返します。
- Instagram Reels Search API — テキストクエリで公開リールを検索し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、クエリ情報を返します。
- Instagram Location Info API — IDまたはロケーションページのURLから1つのロケーションを照会し、名称、カテゴリ、電話番号、座標、タグ付けされた投稿数を返します。
- Instagram Followers Count API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info 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 Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API