hongben-server/docs/task/20260212.md

任务文档

任务1

• Instagram api 调用接口详情示例在docs\api\instagram\api调用.md

• 按照以下信息进行Instagram接口开发： docs\api\instagram\api调用.md文档，结合现有 TikTok 红人采集模式（搜索 -> 详情 -> 作品 -> 评论），构建 Instagram 红人博主库需要以下 4 个核心接口步骤：

1. 发现红人 (Discovery)

对标 TikTok: 关键词搜索用户 ( searchUsers ) Instagram 接口: fetch_search (综合搜索)

• API 路径: /api/v1/instagram/v1/fetch_search
• 关键参数:
  • query : 搜索关键词（如 "fashion", "travel"）
  • select : 固定为 "users" (仅筛选用户)

• 用途: 获取红人候选列表，提取 username 用于后续采集。

  2. 红人画像分析 (Profile Analytics)

  对标 TikTok: 用户详情 ( unique_id 获取 stats) Instagram 接口: fetch_user_info_by_username_v3 (获取用户详情V3)

• API 路径: /api/v1/instagram/v1/fetch_user_info_by_username_v3

• 关键参数:

  • username : Instagram 用户名

• 核心数据:

  • pk/id : 用户ID (后续接口必需)
  • follower_count : 粉丝数 (红人分级依据)
  • biography & bio_links : 简介与外链 (带货能力评估)

  • is_verified : 是否认证

    3. 内容数据采集 (Content Strategy)

    对标 TikTok: 作品列表 ( videos 列表) Instagram 接口: 这里有两个选择，建议组合使用以覆盖图文和短视频：

• 常规帖子 (Posts): fetch_user_posts_v2

  • API 路径: /api/v1/instagram/v1/fetch_user_posts_v2
  • 参数: user_id (来自步骤2), count , end_cursor (分页)
  • 数据: 帖子图片、文案、点赞数、发布时间。

• 短视频 (Reels) - 更贴近 TikTok 模式 : fetch_user_reels

  • API 路径: /api/v1/instagram/v1/fetch_user_reels
  • 参数: user_id , max_id (分页)

  • 数据: 视频播放量、封面、时长。

    4. 深度互动分析 (Engagement - Optional)

    对标 TikTok: 评论采集 (舆情分析) Instagram 接口: fetch_post_comments_v2 (获取评论V2)

• API 路径: /api/v1/instagram/v1/fetch_post_comments_v2

• 关键参数:

  • media_id : 帖子ID (来自步骤3)
  • sort_order : "popular" (热门) 或 "recent"

• 用途: 采集粉丝评论内容，用于分析粉丝画像和情感倾向。

  总结：采集流程建议

• 调用 fetch_search 批量获取 username 。

• 遍历列表调用 fetch_user_info_by_username_v3 获取粉丝数等指标，过滤掉不达标的红人，并记录 user_id 。

• 对达标红人调用 fetch_user_posts_v2 或 fetch_user_reels 采集近期作品表现。

• (可选) 对爆款内容调用 fetch_post_comments_v2 进行深度分析。

• Instagram接口开发需要在modules\fmode-tikhub-server目录下与tiktok接口模块保持模块化开发，apikey还是一样的，只是接口路径前缀不同