# 任务文档
## 任务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"
- 用途: 采集粉丝评论内容，用于分析粉丝画像和情感倾向。
### 总结：采集流程建议
1. 调用 fetch_search 批量获取 username 。
2. 遍历列表调用 fetch_user_info_by_username_v3 获取粉丝数等指标，过滤掉不达标的红人，并记录 user_id 。
3. 对达标红人调用 fetch_user_posts_v2 或 fetch_user_reels 采集近期作品表现。
4. (可选) 对爆款内容调用 fetch_post_comments_v2 进行深度分析。

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