Creator Data
Creator discovery and public contact information.
Creator Data 操作
WaveInflu 邮箱查询
查询一个创作者资料的联系方式。发送 profile_url。响应包含 requestId、billingRequestId 以及 data;data 中有 platform、profile_url 和一个包含 status 与 value 的 email 对象。email 的 status 为 not_found、value 为 null 也属于有效的查询结果。billingRequestId 是提供方参考号,不是 Felo 计费凭证。
计费参考
- 计量方式:套餐资源单位。
- 参考请求估算:0.001991 美元。
- 单位成本基准:0.001991 美元。
- 资源单位:
email_lookup_point。 - 参考客户倍率:1.0。不得对已结算的客户金额再次应用。
- 成本基准不构成最终客户价格,即使为零也不例外。
仅供参考的元数据,不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
请求体
必填
application/json
- 类型: stringprofile
_url
响应
- 类型: object200
邮箱查询已完成
- 类型: stringbilling
Request Id 提供方计费参考,并非 Felo 计费凭证。
- 类型: object · ResponseEb32A34A5274_EmailLookupDatadata
- email类型: object · ResponseEb32A34A5274_EmailResult
- status类型: string
查询结果:成功解析到地址时为
found,否则为未找到状态。未找到属于正常结果,仍按一次有效查询计费。 - value类型: string | null
主要联系邮箱;未找到时为 null。
- platform类型: string
从主页 URL 解析出的平台:instagram、tiktok 或 youtube。
- profile类型: string
_url 本次查询使用的规范化创作者主页 URL。
- 类型: stringrequest
Id 用于支持和监控的请求 ID。
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求,请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应;上游透传响应可能采用提供方格式
application/json
Request Example for post/v1/beta/waveinflu/email-lookup
curl --request POST https://openapi.felo.ai/v1/beta/waveinflu/email-lookup \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"profile_url": "https://www.youtube.com/@example-creator"}'
{
"requestId": "example-request",
"billingRequestId": "example-provider-billing",
"data": {
"platform": "youtube",
"profile_url": "https://www.youtube.com/@example-creator",
"email": {
"status": "not_found",
"value": null
}
}
}