# 相似创作者

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