# 相似創作者

**API:** Data API

**Endpoint:** `POST /v1/beta/waveinflu/similar`

**Tags:** Creator Data

使用必填的 target_account 尋找相似創作者。platform 為選填，預設 youtube，支援 instagram、tiktok 與 youtube。請依文件所述的篩選器縮小結果範圍。billingRequestId 是供應商參考編號，並非 Felo 計費憑證。

### 計費參考

- 計量方式：依回應單位計量。
- 參考請求估算：0.124425 美元。
- 單位成本基準：0.004977 美元。
- 資源單位：`similar_creator_point`。
- 參考客戶乘數：1.0。不得再次套用於已結算的客戶金額。
- 成本基礎不構成最終客戶價格，即使為零亦同。

僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "platform": {
      "default": "youtube",
      "enum": [
        "instagram",
        "tiktok",
        "youtube"
      ],
      "type": "string"
    },
    "target_account": {
      "type": "string",
      "description": "種子帳號：用於尋找相似創作者的創作者帳號（可帶或不帶 @）或個人檔案 URL。",
      "example": "@onkimia"
    },
    "limit": {
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "filters": {
      "type": "object",
      "description": "比對前套用的選用篩選條件。所有欄位均為選用。",
      "properties": {
        "regions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "創作者地區（ISO 國家代碼），例如 [\"US\", \"GB\", \"JP\"]。"
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "創作者語言，例如 [\"en\", \"ja\", \"zh-cn\"]。"
        },
        "minFollowers": {
          "type": "number",
          "description": "粉絲數／訂閱數下限。"
        },
        "maxFollowers": {
          "type": "number",
          "description": "粉絲數／訂閱數上限。"
        },
        "minPlayCount": {
          "type": "number",
          "description": "播放次數／觀看次數下限，由 `playCountMetric` 衡量。"
        },
        "maxPlayCount": {
          "type": "number",
          "description": "播放次數／觀看次數上限，由 `playCountMetric` 衡量。"
        },
        "playCountMetric": {
          "type": "string",
          "enum": [
            "median",
            "average"
          ],
          "description": "`minPlayCount` / `maxPlayCount` 是與播放次數中位數還是平均值比較。"
        },
        "genders": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "推斷的創作者性別，例如 [\"female\", \"male\"]。"
        },
        "ethnicities": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "推斷的創作者族裔。"
        },
        "creatorTypes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "創作者帳號類型，例如 [\"individual\", \"brand\"]。"
        },
        "faceVisibilities": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "人臉可見性分類，例如 [\"clear_face\", \"mixed\", \"no_face\"]。"
        },
        "workspaceDeduplicationEnabled": {
          "type": "boolean",
          "description": "為 true 時，結果中會排除已儲存在你工作區的創作者。"
        }
      }
    }
  },
  "required": [
    "target_account"
  ]
}
```

## Responses

### 200 — 已傳回相似創作者

Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "用於支援與監控的請求 ID。",
      "example": "req-b33"
    },
    "billingRequestId": {
      "type": "string",
      "description": "供應商計費參考，並非 Felo 計費憑證。",
      "example": "a328145e-3cc9-45c7-89f9-a5f15b236d4f"
    },
    "data": {
      "$ref": "#/components/schemas/ResponseEb32A34A5274_CreatorSearchData"
    }
  }
}
```

### 400 — 無法處理該要求。請檢查請求參數。

### 401 — 需要有效的 Felo API 金鑰。

### 402 — 由於未符合計費要求，要求無法繼續。

### 403 — 該帳戶無權執行此操作。

### 429 — 已達到要求或支出上限。

### 502 — 服務無法完成該要求。

### 503 — API 或計費服務暫時無法使用。

### 504 — 服務在處理要求時逾時。

### default — 錯誤回應；上游透傳回應可能採用供應商格式

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseEb32A34A5274_Creator

`#/components/schemas/ResponseEb32A34A5274_Creator`

```json
{
  "type": "object",
  "description": "符合的創作者。在「相似創作者」與「AI 搜尋」中欄位一致。",
  "properties": {
    "id": {
      "type": "string",
      "description": "平台端的創作者 ID。"
    },
    "username": {
      "type": "string",
      "description": "創作者帳號名稱（不含開頭的 @）。"
    },
    "fullName": {
      "type": "string",
      "description": "創作者顯示名稱。"
    },
    "biography": {
      "type": "string",
      "description": "個人資料簡介文字。"
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "從個人資料中擷取的聯絡電子郵件（如可用）。"
    },
    "followerCount": {
      "type": "number",
      "description": "追蹤者／訂閱者數量。"
    },
    "region": {
      "type": "string",
      "description": "創作者地區（ISO 國家代碼）。"
    },
    "language": {
      "type": "string",
      "description": "主要內容語言。"
    },
    "averagePlayCount": {
      "type": "number",
      "description": "近期貼文的平均播放／觀看次數。"
    },
    "medianPlayCount": {
      "type": "number",
      "description": "近期貼文的播放／觀看次數中位數。"
    },
    "averageEngagementRate": {
      "type": "number",
      "description": "平均互動率（0–1）。"
    },
    "medianEngagementRate": {
      "type": "number",
      "description": "互動率中位數（0–1）。"
    },
    "gender": {
      "type": "string",
      "description": "推斷的性別，或 `unknown`。"
    },
    "ageRange": {
      "type": "string",
      "description": "推斷的年齡層（例如 `25_34`），或 `unknown`。"
    },
    "ethnicity": {
      "type": "string",
      "description": "推斷的族裔，或 `unknown`。"
    },
    "faceVisibility": {
      "type": "string",
      "description": "臉部可見性分類，例如 `clear_face`、`mixed`、`no_face`。"
    },
    "accountPositioning": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "概括創作者利基／定位的簡短 AI 產生標籤。"
    },
    "aiDescription": {
      "type": "string",
      "description": "對創作者內容、風格與典型視覺的 AI 產生摘要。"
    },
    "platform": {
      "type": "string",
      "description": "此創作者所屬的平台：instagram、tiktok 或 youtube。"
    },
    "profileUrl": {
      "type": "string",
      "description": "創作者個人檔案 URL。"
    },
    "score": {
      "type": "number",
      "description": "匹配相關度分數（0–1），由高至低排序。"
    }
  }
}
```

### ResponseEb32A34A5274_CreatorSearchData

`#/components/schemas/ResponseEb32A34A5274_CreatorSearchData`

```json
{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseEb32A34A5274_Creator"
      },
      "description": "匹配的創作者，依 `score` 由高至低排序。"
    },
    "count": {
      "type": "number",
      "description": "傳回的創作者數量。計費以此實際交付數量為準。",
      "example": 2
    }
  }
}
```