Creator Data
Creator discovery and public contact information.
Nhà sáng tạo tương tự
Tìm các nhà sáng tạo tương tự bằng target_account bắt buộc. platform là tùy chọn, mặc định là youtube và hỗ trợ instagram, tiktok và youtube. Tuân theo các bộ lọc đã được ghi tài liệu để thu hẹp kết quả. billingRequestId là tham chiếu của nhà cung cấp, không phải biên lai thanh toán của Felo.
Tham chiếu giá
- Đo lường: Đơn vị phản hồi được đo lường.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.124425.
- Cơ sở chi phí đơn vị: USD 0.004977.
- Đơn vị tài nguyên:
similar_creator_point. - Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
- Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: stringtarget
_account bắt buộcTài khoản seed: handle của nhà sáng tạo (có hoặc không có @) hoặc URL hồ sơ để tìm các nhà sáng tạo tương tự.
- Kiểu: objectfilters
Các bộ lọc tùy chọn được áp dụng trước khi khớp. Mọi trường đều tùy chọn.
- creatorKiểu: array string[]
Types Các loại tài khoản nhà sáng tạo, ví dụ ["individual", "brand"].
- ethnicitiesKiểu: array string[]
Dân tộc của nhà sáng tạo được suy luận.
- faceKiểu: array string[]
Visibilities Phân loại mức độ hiển thị khuôn mặt, ví dụ ["clear_face", "mixed", "no_face"].
- gendersKiểu: array string[]
Giới tính của nhà sáng tạo được suy luận, ví dụ ["female", "male"].
- languagesKiểu: array string[]
Ngôn ngữ của nhà sáng tạo, ví dụ ["en", "ja", "zh-cn"].
- maxKiểu: number
Followers Số người theo dõi / người đăng ký tối đa.
- maxKiểu: number
Play Count Số lượt phát / lượt xem tối đa, được đo bằng
playCountMetric. - minKiểu: number
Followers Số người theo dõi / người đăng ký tối thiểu.
- minKiểu: number
Play Count Số lượt phát / lượt xem tối thiểu, được đo bằng
playCountMetric. - playKiểu: string enum
Count Metric Việc
minPlayCount/maxPlayCountđược so sánh với trung vị hay số lượt phát trung bình.giá trị- median
- average
- regionsKiểu: array string[]
Khu vực của nhà sáng tạo (mã quốc gia ISO), ví dụ ["US", "GB", "JP"].
- workspaceKiểu: boolean
Deduplication Enabled Khi là true, các nhà sáng tạo đã lưu trong không gian làm việc của bạn bị loại khỏi kết quả.
- Kiểu: integerlimittối thiểu:1tối đa:100
Integer numbers.
- Kiểu: string enumplatformgiá trị
- instagram
- tiktok
- youtube
- Kiểu: object200
Nhà sáng tạo tương tự được trả về.
- Kiểu: stringbilling
Request Id Tham chiếu thanh toán của nhà cung cấp, không phải biên lai thanh toán Felo.
- Kiểu: object · ResponseEb32A34A5274_CreatorSearchDatadata
- countKiểu: number
Số nhà sáng tạo được trả về. Tính phí dựa trên số lượng được trả về này.
- itemsKiểu: array object[] · ResponseEb32A34A5274_Creator[]
Các nhà sáng tạo khớp, sắp xếp theo
scoregiảm dần.Một nhà sáng tạo được khớp. Các trường nhất quán giữa Similar Creators và AI Search.
- accountKiểu: array string[]
Positioning Thẻ ngắn do AI tạo, tóm tắt ngách / định vị của nhà sáng tạo.
- ageKiểu: string
Range Khoảng tuổi được suy ra (ví dụ
25_34), hoặcunknown. - aiKiểu: string
Description Tóm tắt do AI tạo về nội dung, phong cách và hình ảnh thường thấy của nhà sáng tạo.
- averageKiểu: number
Engagement Rate Tỷ lệ tương tác trung bình (0–1).
- averageKiểu: number
Play Count Số lượt phát / lượt xem trung bình trên các bài đăng gần đây.
- biographyKiểu: string
Văn bản tiểu sử hồ sơ.
- emailKiểu: string | null
Email liên hệ được trích xuất từ hồ sơ, khi có.
- ethnicityKiểu: string
Dân tộc được suy ra, hoặc
unknown. - faceKiểu: string
Visibility Phân loại độ hiển thị khuôn mặt, ví dụ
clear_face,mixed,no_face. - followerKiểu: number
Count Số người theo dõi / người đăng ký.
- fullKiểu: string
Name Tên hiển thị của nhà sáng tạo.
- genderKiểu: string
Giới tính được suy ra, hoặc
unknown. - idKiểu: string
ID nhà sáng tạo phía nền tảng.
- languageKiểu: string
Ngôn ngữ nội dung chính.
- medianKiểu: number
Engagement Rate Tỷ lệ tương tác trung vị (0–1).
- medianKiểu: number
Play Count Số lượt phát / xem trung vị trên các bài đăng gần đây.
- platformKiểu: string
Nền tảng của nhà sáng tạo này: instagram, tiktok hoặc youtube.
- profileKiểu: string
Url URL hồ sơ nhà sáng tạo.
- regionKiểu: string
Khu vực của nhà sáng tạo (mã quốc gia ISO).
- scoreKiểu: number
Điểm liên quan của kết quả khớp (0–1), sắp xếp giảm dần.
- usernameKiểu: string
Tên người dùng của nhà sáng tạo (không có @ ở đầu).
- Kiểu: stringrequest
Id Request ID để hỗ trợ và giám sát.
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
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
}
}