Felo API PlatformFelo API Platform
全部 Creator Discovery 端点
v0.2.0-beta
OpenAPI 3.1.0

相似创作者

Felo API Support
MIT
服务器:https://openapi.felo.ai
客户端库
Shell Curl

Creator Data

​

Creator discovery and public contact information.

Creator Data 操作

相似创作者

​

使用必填的 target_account 查找相似创作者。platform 为可选，默认 youtube，支持 instagram、tiktok 和 youtube。按照文档中的过滤器缩小结果范围。billingRequestId 是提供方参考号，不是 Felo 计费凭证。

计费参考

  • 计量方式：按响应单位计量。
  • 参考请求估算：0.124425 美元。
  • 单位成本基准：0.004977 美元。
  • 资源单位：similar_creator_point。
  • 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
  • 成本基准不构成最终客户价格，即使为零也不例外。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

请求体
必填
application/json
  • target_account
    类型: string
    必填

    种子账号：用于查找相似创作者的创作者账号（可带或不带 @）或主页 URL。

  • filters
    类型: object

    匹配前应用的可选筛选条件。所有字段均为可选。

    • creatorTypes
      类型: array string[]

      创作者账号类型，例如 ["individual", "brand"]。

    • ethnicities
      类型: array string[]

      推断的创作者族裔。

    • faceVisibilities
      类型: array string[]

      人脸可见性分类，例如 ["clear_face", "mixed", "no_face"]。

    • genders
      类型: array string[]

      推断的创作者性别，例如 ["female", "male"]。

    • languages
      类型: array string[]

      创作者语言，例如 ["en", "ja", "zh-cn"]。

    • maxFollowers
      类型: number

      粉丝数/订阅数上限。

    • maxPlayCount
      类型: number

      播放量/观看量上限，由 playCountMetric 度量。

    • minFollowers
      类型: number

      粉丝数/订阅数下限。

    • minPlayCount
      类型: number

      播放量/观看量下限，由 playCountMetric 度量。

    • playCountMetric
      类型: string 枚举

      minPlayCount / maxPlayCount 是与播放量中位数还是平均值比较。

      值
      • median
      • average
    • regions
      类型: array string[]

      创作者地区（ISO 国家代码），例如 ["US", "GB", "JP"]。

    • workspaceDeduplicationEnabled
      类型: boolean

      为 true 时，结果中会排除已保存在你工作区的创作者。

  • limit
    类型: integer
    最小值:  
    1
    最大值:  
    100

    Integer numbers.

  • platform
    类型: string 枚举
    值
    • instagram
    • tiktok
    • youtube
响应
  • 200
    类型: object

    已返回相似创作者

    • billingRequestId
      类型: string

      提供方计费参考，并非 Felo 计费凭证。

    • data
      类型: object · ResponseEb32A34A5274_CreatorSearchData
      • count
        类型: number

        返回的创作者数量。计费以此实际交付数量为准。

      • items
        类型: array object[] · ResponseEb32A34A5274_Creator[]

        匹配的创作者，按 score 降序排列。

        匹配到的创作者。在「相似创作者」和「AI 搜索」中字段一致。

        • accountPositioning
          类型: array string[]

          概括创作者细分领域/定位的简短 AI 生成标签。

        • ageRange
          类型: string

          推断的年龄段（例如 25_34），或 unknown。

        • aiDescription
          类型: string

          对创作者内容、风格和典型视觉的 AI 生成摘要。

        • averageEngagementRate
          类型: number

          平均互动率（0–1）。

        • averagePlayCount
          类型: number

          近期帖子的平均播放/观看次数。

        • biography
          类型: string

          个人资料简介文本。

        • email
          类型: string | null

          从个人资料中提取的联系邮箱（如可用）。

        • ethnicity
          类型: string

          推断的族裔，或 unknown。

        • faceVisibility
          类型: string

          面部可见性分类，例如 clear_face、mixed、no_face。

        • followerCount
          类型: number

          关注者/订阅者数量。

        • fullName
          类型: string

          创作者显示名称。

        • gender
          类型: string

          推断的性别，或 unknown。

        • id
          类型: string

          平台侧的创作者 ID。

        • language
          类型: string

          主要内容语言。

        • medianEngagementRate
          类型: number

          互动率中位数（0–1）。

        • medianPlayCount
          类型: number

          近期帖子的播放/观看次数中位数。

        • platform
          类型: string

          该创作者所属的平台：instagram、tiktok 或 youtube。

        • profileUrl
          类型: string

          创作者主页 URL。

        • region
          类型: string

          创作者地区（ISO 国家代码）。

        • score
          类型: number

          匹配相关度评分（0–1），按降序排列。

        • username
          类型: string

          创作者账号名（不含开头的 @）。

    • requestId
      类型: string

      用于支持和监控的请求 ID。

    application/json
  • 400

    无法处理该请求。请检查请求参数。

  • 401

    需要有效的 Felo API 密钥。

  • 402

    由于未满足计费要求，请求无法继续。

  • 403

    该账户无权执行此操作。

  • 429

    已达到请求或支出限额。

  • 502

    服务无法完成该请求。

  • 503

    API 或计费服务暂时不可用。

  • 504

    服务在处理请求时超时。

  • default

    错误响应；上游透传响应可能采用提供方格式

    application/json
Request Example for post/v1/beta/waveinflu/similar
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
  }
}

已返回相似创作者

Similar Creators

需要帮助？