如何通过Twilio API正确使用inLocality筛选器搜索可用号码

架构老林

2026-6-24

解决Twilio API中inLocality筛选无结果的问题

针对你遇到的用inLocality搜索"Santa Clara"无结果的问题，可以尝试以下几种方法：

添加州级参数缩小范围：美国存在多个同名城市，单独使用城市名可能导致API无法精准匹配。结合inRegion参数指定州缩写（比如Santa Clara所在的加州缩写为CA），能大幅提升匹配成功率：
```
numbers = await this.client.availablePhoneNumbers('US').local.list({
        inLocality: 'Santa Clara',
        inRegion: 'CA',
        smsEnabled: true,
        voiceEnabled: true,
      });
```
使用USPS标准化城市名称：Twilio的地理数据基于USPS标准，部分城市可能有官方标准化名称。你可以先在Twilio网页端找到一个目标城市的可用号码，查看其详情页中的"城市"字段，直接复用该字段值作为inLocality的参数。
尝试调整格式：如果上述方法无效，可尝试不带逗号的"城市州缩写"格式，比如inLocality: 'Santa Clara CA'，部分场景下这种格式能被API正确识别。