咨询Clio API的query参数语法：如何按名称搜索联系人

针对你要筛选名称为“James Town”的联系人需求，Clio API的query参数采用类Lucene的查询语法，正确的请求格式如下：

https://app.clio.com/api/v4/contacts.json?query=name:"James Town"

需要注意几个关键细节：

• 必须使用英文双引号包裹带空格的精确值（你之前的请求里误用了中文引号“”，这是导致匹配失败的核心原因）
• 字段名name和冒号:之间不能有空格
• 如果手动拼接URL，需对特殊字符做URL编码，编码后的地址为：

  https://app.clio.com/api/v4/contacts.json?query=name%3A%22James%20Town%22
  

  （Postman等工具会自动完成编码，直接写未编码格式即可）

关于query参数的更多语法规则，Clio API的通用查询说明里涵盖了这些场景：

• 模糊匹配名称包含James的联系人：query=name:James
• 同时匹配名称和类型：query=name:"James Town" AND type:"Company"

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