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به‌صورت نزولی.سازنده محتوای منطبق. فیلدها در Similar Creators و AI Search یکسان هستند.
- 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
شناسه سازنده در سمت پلتفرم.
- 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 شناسه درخواست برای پشتیبانی و پایش.
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 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
}
}