عدد متابعي TikTok ومعلومات الملف الشخصي عبر واجهة برمجة التطبيقات (API)
تعيد واجهة API for Business عدد متابعي الحساب باسم followers_count من GET /business/get/، إلى جانب username وdisplay_name وprofile_image وbio_description وis_verified وfollowing_count وtotal_likes وvideos_count. ويحتاج كل حقل منها إلى نطاق مثل user.info.stats. أما /v2/user/info/ في Display API فيعيد العدد نفسه باسم follower_count للمستخدم الذي فوّض التطبيق.
يقرأ easyCoexistence ملف حساب TikTok وعدد متابعيه عبر get_social_insights من Claude أو ChatGPT أو من كودك الخاص: اذكر حقولًا مثل followers_count وtotal_likes وvideos_count، مع التواريخ للصفوف اليومية، فيعيد أرقام TikTok كما هي.
النطاق المطلوب لـ followers_count وfollowing_count وtotal_likes وvideos_count، ويُذكر في أعلى /business/get/.
كيف يحدّث TikTok followers_count وحقول الملف الشخصي، بينما تصل المقاييس اليومية عادةً بعد 24 إلى 48 ساعة.
الاسم الذي تستخدمه Display API للعدد في /v2/user/info/، ضمن نطاق user.info.stats الخاص بها.
أطول فترة رجوع للبيانات اليومية لـ followers_count والمقاييس اليومية الأخرى في /business/get/.
ما يعيده /business/get/ عند عدم تسمية أي حقول: display_name وprofile_image.
أي حقول الملف الشخصي تعيدها /business/get/؟
الحقول المذكورة في fields، وهي مصفوفة JSON في سلسلة الاستعلام، ويفتح كل منها نطاق منحه مالك الحساب عند تفويض التطبيق. يعيد الطلب الذي لا يذكر أي حقول display_name وprofile_image فقط، ويحدّث TikTok حقول الملف وحقول العدد أدناه في الوقت الفعلي:
كيف تطلب عدد المتابعين؟
بطلب GET إلى /business/get/، مع رمز الوصول للحساب في الترويسة Access-Token، وbusiness_id، وهو open_id الناتج عن تبادل الرمز، إضافةً إلى الحقول التي تريدها. تظهر الأعداد الحالية في أعلى data، وأرقام كل يوم في metrics:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"display_name": "<DISPLAY_NAME>",
"followers_count": 13,
"following_count": 2,
"is_verified": false,
"metrics": [
{ "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
]
}
}كيف تتابع المتابعين يومًا بيوم؟
اذكر followers_count في fields فيعيده TikTok مرتين: الإجمالي منذ البداية في أعلى data تحت user.info.stats، والإجمالي لكل يوم داخل metrics تحت user.insights. يحدد start_date وend_date، بالتوقيت العالمي UTC، الأيام المطلوبة حتى 60 يومًا للخلف، وبدونهما يعيد TikTok آخر 7 أيام حتى اليوم السابق للطلب. وتكشف ثلاثة حقول يومية الحركة وراء الإجمالي، للحسابات ذات Advanced Access أو Verified Business Account:
daily_new_followers: عدد المتابعين الجدد في ذلك اليوم.daily_lost_followers: عدد المتابعين الذين فُقدوا في ذلك اليوم.daily_total_followers: صافي النمو في ذلك اليوم، أي المكاسب مطروحًا منها الخسائر.
ماذا تعيد Display API؟
الملف الشخصي نفسه تقريبًا للمستخدم الذي فوّض تطبيقًا من TikTok for Developers، من GET https://open.tiktokapis.com/v2/user/info/ مع الحقول المذكورة في معامل fields. وتختلف أسماؤها ونطاقاتها عن API for Business، ولا يحمل كائن user فيها أي سجل يومي:
| API for Business: /business/get/ | Display API: /v2/user/info/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not in the user object |
هل يمكنك قراءة عدد متابعي حساب آخر؟
ليس بهاتين النقطتين. يجيب /business/get/ عن business_id لحساب فوّض التطبيق، ويجيب /v2/user/info/ عن المستخدم الذي يحمل رمزه الطلب. تملك Research API من TikTok نقطة /v2/research/user/info/ تقبل اسم المستخدم username وتعيد follower_count وfollowing_count وlikes_count وvideo_count، لكن للباحثين الذين وافقت عليهم TikTok فقط.
كيف يقرأ easyCoexistence الملف الشخصي؟
باستخدام get_social_insights على الحساب دون object_id: تصبح الأسماء في metrics حقولًا في /business/get/، وتحدد start_date وend_date في params الأيام، ويعيد النتيجة كما هي من بيانات TikTok. تعيد القائمة الفارغة في metrics اسم المستخدم واسم العرض والصورة وعدد المتابعين وعدد الحسابات المتابَعة والإعجابات والفيديوهات، والعلامتين على مستوى الحساب، والمشاهدات اليومية للفيديو ومشاهدات الملف الشخصي والمتابعين الجدد. ويعرض list_social_accounts أيضًا اسم المستخدم واسم العرض المحفوظين عند ربط الحساب.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
"params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}الأخطاء الشائعة
- طلب followers_count دون user.info.stats في الرمز. لا يعيد TikTok كل حقل إلا إذا منح المالك نطاقه، لذا على المالك أن يفوّض التطبيق من جديد.
- حفظ profile_image لوقت لاحق. هو رابط مؤقت تظهر مدة انتهائه في معامله x-expires، فاطلب رابطًا جديدًا عند الحاجة إليه.
- قراءة follower_count من /business/get/. هذا اسم Display API، أما API for Business فيسميه followers_count.
- توقع المتابعين الجدد والمفقودين في حساب شخصي. يعيد TikTok هذه الحقول اليومية لحسابات Advanced Access أو Verified Business Account فقط.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض مع إضافة اتصالات أخرى، مع فترة تجريبية مجانية مدتها 3 أيام تبدأ من أول اتصال.
الأسئلة الشائعة
هل يعرض TikTok API نمو المتابعين عبر الزمن؟
نعم، لمدة تصل إلى 60 يومًا: followers_count لكل يوم داخل metrics، إضافةً إلى المتابعين الجدد والمفقودين والصافي اليومي في حسابات Advanced Access أو Verified Business Account.
أي نطاق يحتاجه عدد متابعي TikTok؟
user.info.stats في الواجهتين معًا: يفتح followers_count في /business/get/ وfollower_count في /v2/user/info/ من Display API.
هل يعيد حساب TikTok شخصي عدد متابعيه؟
نعم. يعتمد followers_count على النطاق لا على نوع الحساب، ولا تحتاج إلا بعض الحقول اليومية إلى Advanced Access أو Verified Business Account.
كم مرة يتحدث عدد متابعي TikTok؟
يعلّم TikTok الحقل followers_count في المستوى الأعلى بأنه في الوقت الفعلي، بينما تصل الصفوف اليومية في metrics عادةً متأخرة 24 إلى 48 ساعة، بالتوقيت العالمي UTC.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في