Creator Data
Creator discovery and public contact information.
類似クリエイター
必須の target_account を使用して類似クリエイターを検索します。platform は任意で、既定は youtube です。instagram、tiktok、youtube をサポートします。ドキュメントに記載されたフィルターで結果を絞り込んでください。billingRequestId はプロバイダーの参照 ID であり、Felo の請求書ではありません。
料金の参考情報
- 計測方法：レスポンスユニット単位で計測。
- 参考リクエスト見積もり：0.124425 USD。
- ユニットコスト基準：USD 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
}
}