Instagram API

Instagram APIは、ユーザープロフィールの検索、投稿・リール・タグ付けされたメディアの一覧表示、ストーリーの読み取り、投稿詳細の取得、コメントと返信の読み取り、ユーザーとハッシュタグの検索、ソーシャルグラフ（フォロワー/フォロー中）の取得を可能にします。12のエンドポイントがあり、各リクエストは2クレジットです。

エンドポイント

認証

すべての成功レスポンスには、クレジット追跡フィールドが含まれます: credits_used, credits_remaining, response_time (ms)。

ユーザーの特定

ユーザーエンドポイントはいずれかのusernameまたは数値のuser_idを受け付けます。usernameを渡すのが最も簡単な方法で、自動的にuser_idに解決されます。繰り返し呼び出す場合は、プロフィールレスポンスからdata.user.idを読み取り、それをuser_idとして渡すことで検索をスキップできます。

ユーザープロフィール

POST https://api.scavio.dev/api/v1/instagram/profile

Instagramユーザープロフィールを取得します。いずれかの usernameまたはuser_idを渡してください。

リクエストボディ

例

curl -X POST 'https://api.scavio.dev/api/v1/instagram/profile' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"username": "instagram"}'

レスポンスフィールド (data.user)

レスポンス例

{
  "data": {
    "user": {
      "id": "25025320",
      "username": "instagram",
      "full_name": "Instagram",
      "biography": "Discover what's next on Instagram",
      "is_verified": true,
      "is_private": false,
      "edge_followed_by": { "count": 672000000 },
      "edge_follow": { "count": 250 },
      "edge_owner_to_timeline_media": { "count": 7600 }
    }
  },
  "response_time": 845,
  "credits_used": 2,
  "credits_remaining": 11750
}

ユーザー投稿

POST https://api.scavio.dev/api/v1/instagram/user/posts

ユーザーの投稿（タイムラインメディア）を一覧表示します。usernameまたは user_idを渡してください。

リクエストボディ

ページネーション

次のリクエストのcursorとしてdata.page_info.end_cursorを使用します。data.page_info.has_next_pageが falseになったら停止します。

ユーザーリール (/api/v1/instagram/user/reels) およびタグ付けされた投稿 (/api/v1/instagram/user/tagged)は、ユーザー投稿と同じパラメータとページネーションを使用し、それぞれリールとタグ付けされたメディアを返します。

ユーザーストーリー

POST https://api.scavio.dev/api/v1/instagram/user/stories

ユーザーの現在アクティブなストーリーを取得します。usernameまたは user_idを渡してください。各ストーリーのメディアURL、タイプ（画像/動画）、タイムスタンプを返します。

投稿詳細

POST https://api.scavio.dev/api/v1/instagram/post

単一の投稿またはリールの詳細を取得します。いずれか一つの url、media_id、またはshortcodeを渡してください。

リクエストボディ

例

curl -X POST 'https://api.scavio.dev/api/v1/instagram/post' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"shortcode": "DUajw4YkorV"}'

投稿コメント

POST https://api.scavio.dev/api/v1/instagram/post/comments

投稿のコメントを取得します。いずれかの shortcodeまたは投稿のurlを渡してください。

リクエストボディ

ページネーション

次のcursorとしてdata.next_min_idを使用します。存在しなくなったら停止します。各コメントにはpkフィールドがあり、それを返信エンドポイントのcomment_idとして使用します。

コメント返信

POST https://api.scavio.dev/api/v1/instagram/post/comments/replies

特定のコメントへの返信を取得します。

リクエストボディ

ユーザー検索

POST https://api.scavio.dev/api/v1/instagram/search/users

キーワードでInstagramユーザーを検索します。

リクエストボディ

ハッシュタグ検索 (/api/v1/instagram/search/hashtags) は同じパラメータを受け取り、一致するハッシュタグとそのメディア数を返します。

ユーザーフォロワー

POST https://api.scavio.dev/api/v1/instagram/user/followers

ユーザーのフォロワーリストを取得します。usernameまたはuser_idを渡してください。

リクエストボディ

ユーザーフォロー中

POST https://api.scavio.dev/api/v1/instagram/user/followings

ユーザーがフォローしているアカウントを取得します。リクエストの形式とパラメータはフォロワーと同じです。

ページネーションリファレンス

注意事項

• すべてのエンドポイントはリクエストごとに2クレジットを消費します。
• ユーザーエンドポイントはusernameまたは数値の user_idを受け付けます。投稿エンドポイントはurl、 media_id、またはshortcodeを受け付けます。
• フォロワーとフォロー中のリストは、Instagramが許可するアカウントに限りページネーション可能です。大規模または認証済みアカウントは should_limit_list_of_followers: true、 has_more: false、およびnext_max_idなしを返します。これはInstagramの制限であり、エラーではありません。小規模で未認証のアカウントでページネーションをテストしてください。
• エラーについては、 401、429、502の処理を参照してください。