MailChimp search-campaigns接口query参数构造及web_id查询求助

问题概述 #

我在导出MailChimp聚合活动数据时，CSV文件里包含了campaign的web_id，想要通过这个ID获取对应活动的详细信息。尝试使用search-campaigns接口，但该接口必填的query参数没有找到构造说明。试了几种写法要么返回无关结果，要么返回0条记录：

• 能正常返回但非目标数据的请求：

  https://${dc}.api.mailchimp.com/3.0/search-members?&query=TRUE
  

• 全部返回0条记录的请求：

  https://${dc}.api.mailchimp.com/3.0/search-members?&query=web_id=12345（12345为目标web_id）
  

  https://${dc}.api.mailchimp.com/3.0/search-members?&query="web_id=12345"
  

  https://${dc}.api.mailchimp.com/3.0/search-members?&query=["web_id":"12345"]
  

  https://${dc}.api.mailchimp.com/3.0/search-members?&query="where web_id=12345"
  

解决方案 #

首先纠正核心误区：你误用了接口——search-members是用来搜索会员的，不是搜索活动的，这就是按web_id查询无结果的根本原因。

要通过web_id获取活动详细信息，直接使用单个活动查询接口即可，无需构造复杂的query参数：

https://${dc}.api.mailchimp.com/3.0/campaigns/{web_id}

把目标web_id替换掉{web_id}占位符，请求成功后就能拿到该活动的完整详细数据。

如果确实需要用search-campaigns接口（比如批量匹配活动），注意该接口的query参数仅支持搜索活动的名称、主题、发件人邮箱这类文本内容，不支持直接按web_id筛选。这种场景下，单个活动接口依然是最高效的选择。

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