使用Intercom API获取分段用户出现结果不一致问题求助

数据老陈

2026-5-26

解决Intercom分段用户批量获取的分页问题

嘿，这个问题我熟！你遇到的核心问题是没有正确使用Intercom API的游标分页机制，导致每次调用都返回随机的用户子集，而不是按顺序分页获取全部用户。下面是具体的解决步骤和原因分析：

为什么会重复返回全新用户？

Intercom的用户列表API（包括按分段筛选）并不使用传统的offset分页，而是采用基于游标（cursor-based）的分页方式。当你只传per_page和segment_id时，API默认会返回当前符合条件的一批随机/最新用户，而不是分页的后续内容——这就是为什么每次调用都拿到全新的60个用户。

正确的批量获取流程

要获取分段内全部2500个用户，你需要按以下步骤操作：

第一步：发起初始请求，获取第一页用户和游标信息
```
GET https://api.intercom.io/users?per_page=60&segment_id=3baabac0c422f15fcfb7f760
```
在返回的响应体中，找到pages字段，里面会包含next参数（这就是下一页的游标标识）。
第二步：使用游标请求下一页
把上一步得到的next游标作为参数加入请求，比如：
```
GET https://api.intercom.io/users?per_page=60&segment_id=3baabac0c422f15fcfb7f760&cursor=abc123xyz
```
这个请求会返回紧接着上一页的60个用户，不会重复也不会遗漏。
第三步：循环直到获取全部用户
重复第二步，每次用响应里的pages.next作为下一次请求的游标，直到响应中的pages.next为空——这说明已经获取完该分段下的所有用户了。