Creator Data
Creator discovery and public contact information.
相似創作者
使用必填的 target_account 尋找相似創作者。platform 為選填，預設 youtube，支援 instagram、tiktok 與 youtube。請依文件所述的篩選器縮小結果範圍。billingRequestId 是供應商參考編號，並非 Felo 計費憑證。
計費參考
- 計量方式：依回應單位計量。
- 參考請求估算：0.124425 美元。
- 單位成本基準：0.004977 美元。
- 資源單位：
similar_creator_point。 - 參考客戶乘數：1.0。不得再次套用於已結算的客戶金額。
- 成本基礎不構成最終客戶價格，即使為零亦同。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: stringtarget
_account 必填種子帳號：用於尋找相似創作者的創作者帳號（可帶或不帶 @）或個人檔案 URL。
- 類型: objectfilters
比對前套用的選用篩選條件。所有欄位均為選用。
- creator類型: array string[]
Types 創作者帳號類型，例如 ["individual", "brand"]。
- ethnicities類型: array string[]
推斷的創作者族裔。
- face類型: array string[]
Visibilities 人臉可見性分類，例如 ["clear_face", "mixed", "no_face"]。
- genders類型: array string[]
推斷的創作者性別，例如 ["female", "male"]。
- languages類型: array string[]
創作者語言，例如 ["en", "ja", "zh-cn"]。
- max類型: number
Followers 粉絲數／訂閱數上限。
- max類型: number
Play Count 播放次數／觀看次數上限，由
playCountMetric衡量。 - min類型: number
Followers 粉絲數／訂閱數下限。
- min類型: number
Play Count 播放次數／觀看次數下限，由
playCountMetric衡量。 - play類型: string 列舉
Count Metric minPlayCount/maxPlayCount是與播放次數中位數還是平均值比較。值- median
- average
- regions類型: array string[]
創作者地區（ISO 國家代碼），例如 ["US", "GB", "JP"]。
- workspace類型: boolean
Deduplication Enabled 為 true 時，結果中會排除已儲存在你工作區的創作者。
- 類型: integerlimit最小值:1最大值:100
Integer numbers.
- 類型: string 列舉platform值
- instagram
- tiktok
- youtube
- 類型: object200
已傳回相似創作者
- 類型: stringbilling
Request Id 供應商計費參考，並非 Felo 計費憑證。
- 類型: object · ResponseEb32A34A5274_CreatorSearchDatadata
- count類型: number
傳回的創作者數量。計費以此實際交付數量為準。
- items類型: array object[] · ResponseEb32A34A5274_Creator[]
匹配的創作者，依
score由高至低排序。符合的創作者。在「相似創作者」與「AI 搜尋」中欄位一致。
- account類型: array string[]
Positioning 概括創作者利基／定位的簡短 AI 產生標籤。
- age類型: string
Range 推斷的年齡層（例如
25_34），或unknown。 - ai類型: string
Description 對創作者內容、風格與典型視覺的 AI 產生摘要。
- average類型: number
Engagement Rate 平均互動率（0–1）。
- average類型: number
Play Count 近期貼文的平均播放／觀看次數。
- biography類型: string
個人資料簡介文字。
- email類型: string | null
從個人資料中擷取的聯絡電子郵件（如可用）。
- ethnicity類型: string
推斷的族裔，或
unknown。 - face類型: string
Visibility 臉部可見性分類，例如
clear_face、mixed、no_face。 - follower類型: number
Count 追蹤者／訂閱者數量。
- full類型: string
Name 創作者顯示名稱。
- gender類型: string
推斷的性別，或
unknown。 - id類型: string
平台端的創作者 ID。
- language類型: string
主要內容語言。
- median類型: number
Engagement Rate 互動率中位數（0–1）。
- median類型: number
Play Count 近期貼文的播放／觀看次數中位數。
- platform類型: string
此創作者所屬的平台：instagram、tiktok 或 youtube。
- profile類型: string
Url 創作者個人檔案 URL。
- region類型: string
創作者地區（ISO 國家代碼）。
- score類型: number
匹配相關度分數（0–1），由高至低排序。
- username類型: string
創作者帳號名稱（不含開頭的 @）。
- 類型: stringrequest
Id 用於支援與監控的請求 ID。
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求，要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應；上游透傳回應可能採用供應商格式
application/json
curl https://openapi.felo.ai/v1/beta/waveinflu/similar \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"platform": "youtube",
"target_account": "@onkimia",
"limit": 25,
"filters": {
"regions": [
""
],
"languages": [
""
],
"minFollowers": 1,
"maxFollowers": 1,
"minPlayCount": 1,
"maxPlayCount": 1,
"playCountMetric": "median",
"genders": [
""
],
"ethnicities": [
""
],
"creatorTypes": [
""
],
"faceVisibilities": [
""
],
"workspaceDeduplicationEnabled": true
}
}'
{
"requestId": "req-b33",
"billingRequestId": "a328145e-3cc9-45c7-89f9-a5f15b236d4f",
"data": {
"items": [
{
"id": "string",
"username": "string",
"fullName": "string",
"biography": "string",
"email": null,
"followerCount": 1,
"region": "string",
"language": "string",
"averagePlayCount": 1,
"medianPlayCount": 1,
"averageEngagementRate": 1,
"medianEngagementRate": 1,
"gender": "string",
"ageRange": "string",
"ethnicity": "string",
"faceVisibility": "string",
"accountPositioning": [
"string"
],
"aiDescription": "string",
"platform": "string",
"profileUrl": "string",
"score": 1
}
],
"count": 2
}
}