---
name: instagram-user-posts
description: 获取指定 Instagram 用户发布的帖子列表，包括点赞数、评论数、帖子文案等。适用于竞品品牌 IG 内容策略分析、KOL 帖子互动表现评估、品牌运营频率分析。
version: 1.3.0
author: nkkj-BrainHack
---

# instagram-user-posts

## 功能用途

获取 Instagram 用户发布的帖子列表，分析内容策略、发帖规律和互动表现。

**核心业务场景：**
- 竞品品牌 IG 内容策略分析（发帖频率、内容主题、帖子互动率）
- KOL 帖子互动表现评估（单帖平均互动率计算）
- 品牌视觉内容风格分析（内容类型分布：图片/视频/轮播）

## 调用链（Workflow）

```
上游: instagram-search(query, select='users') → 搜索品牌/KOL → 取 username
上游: instagram-user-info(username) → 获取 pk 字段和粉丝数
本步: instagram-user-posts(user_id=pk) → 获取帖子列表
分析: 互动率 = (like_count + comment_count) / follower_count
```

## 入参规则

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| user_id | string | ✅ | Instagram 用户数字 ID（pk），从 instagram-user-info 的 user.pk 字段获取 |
| count | integer | ❌ | 每页帖子数量，最大 50（默认 12） |
| end_cursor | string | ❌ | 翻页游标，首次不传，后续传上次返回的 end_cursor |

## 接口调用方式

- **请求方法**: GET
- **接口地址**: `https://server.fmode.cn/api/voc-social/instagram/v1/fetch_user_posts_v2`

```
GET ?user_id=12345678&count=12
```

## 关键响应字段

| 字段路径 | 业务用途 |
|----------|---------|
| items[].id | 帖子 ID |
| items[].caption.text | 帖子文案 → 内容主题分析 |
| items[].like_count | 点赞数 → 互动率计算分子 |
| items[].comment_count | 评论数 → 互动率计算分子 |
| items[].taken_at | 发布时间戳 → 发帖频率分析 |
| items[].media_type | 媒体类型（1=图片 2=视频 8=轮播） → 内容类型分布 |
| items[].view_count | 视频观看次数（仅视频帖子） |
| has_more | 是否还有更多帖子 |
| end_cursor | 下一页游标 |

## 依赖要求

- 统一代理: `https://server.fmode.cn/api/voc-social/`
- 请求方法 GET，参数作为查询参数传递
- **user_id 必须从 instagram-user-info 的 user.pk 字段获取**