用途:Twilio Lookup 用于校验电话号码并可选返回多种智能数据包,适合发送短信或 OTP 前做号码有效性检查,以及按线路类型路由、反欺诈等场景。基础校验免费;线路类型、SIM 换卡等数据包为按次付费。
前提条件:需要 Twilio 账户(免费试用可做基础查询),设置环境变量 TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN,并安装 SDK:pip install twilio / npm install twilio。
主要能力:通过 client.lookups.v2.phone_numbers("+15108675310").fetch() 获取号码,结果含 valid、phone_number(E.164)、national_format、country_code;valid 为 false 时可查看 validationErrors。数据包通过 fields 参数按需请求,可一次请求多个,如 fields="line_type_intelligence,sim_swap,caller_name"。
数据包:Line Type Intelligence(line_type_intelligence,全球)用于识别 mobile、landline、voip、toll-free、fixedVoip、nonFixedVoip、personal、payphone、unknown 等类型;Caller Name(caller_name,仅美国)显示来电者身份;SIM Swap(sim_swap,部分区域)用于欺诈检测;Identity Match(identity_match,部分区域)验证归属;SMS Pumping Risk(sms_pumping_risk,全球)防欺诈;Reassigned Number(reassigned_number,仅美国)检查号码是否被回收。
限制:只支持按号码查询,不能凭姓名或地址反向搜索;caller_name 仅限美国号码,非美国返回 60600;条件呼叫转移无法检测,仅能检测无条件转移且限英国运营商;SIM swap 数据需运营商注册审批,否则返回 60606;Reassigned Number 仅美国且按月更新;SMS pumping 分数为统计模型而非实时流量分析;Lookup v2 为只读(仅 GET),例外是 Line Type Override(POST/DELETE);每次请求只能查询一个号码,批量需循环;caller_name 无数据返回时仍计费;Phone Number Quality Score 与 Pre-fill 需开通才能使用,否则返回 60606;查询有效不代表一定可送达。常见错误:20404 号码未找到,60601 该区域不支持该数据包。