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 وسوم قصيرة مولّدة بالذكاء الاصطناعي تلخص تخصص منشئ المحتوى / تموضعه.
- ageالنوع: string
Range الفئة العمرية المستنتجة (مثل
25_34)، أوunknown. - aiالنوع: string
Description ملخص مولّد بالذكاء الاصطناعي لمحتوى منشئ المحتوى وأسلوبه ومرئياته المعتادة.
- 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
}
}