Mailchimp调查响应API仅返回25条结果问题求助

调用Mailchimp的/reporting/surveys/{outreach_id}/responses端点时，即便目标调查的total_responses显示有大量数据（比如示例中outreach_id为07fca9fc8327的调查总响应数595），无论设置何种分页参数，返回的items数量和total_items始终固定为25，无法获取更多结果。

排查是否是调用方式问题 #

• 确认分页参数的正确性：该端点使用count和offset作为分页参数，不要误用limit或page等其他命名参数，正确的请求参数格式应为?count=1000&offset=0。
• 检查请求方法：必须使用GET请求，其他请求方法不支持该端点的分页逻辑。
• 验证API权限：确保你的API密钥拥有reports_read权限，受限权限可能会强制返回固定数量的结果。

社区反馈与临时解决方案 #

• 已有不少用户在社区反馈过这个端点的分页bug，目前官方尚未发布修复补丁。
• 临时解决办法：通过循环递增offset参数分批拉取数据。每次请求设置count=25，offset从0开始，每次累加25（0、25、50……），直到返回的items为空或者offset超过total_responses数值，以此拼接完整的响应数据集。
• 替代方案：如果场景允许，可通过Mailchimp后台或导出API导出调查响应的CSV文件，再解析文件获取完整数据。

联系官方的补充建议 #

• 除了发送apihelp邮箱，可尝试在Mailchimp开发者论坛发帖，或通过官方支持工单系统提交问题，论坛的社区团队响应速度通常更快。

内容的提问来源于stack exchange，提问作者Nevin M