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
}
}
}