تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

هاشتاغات TikTok عبر API: الاقتراحات والهاشتاغات الرائجة

تقترح واجهة برمجة التطبيقات (API) الخاصة بالأعمال في TikTok هاشتاغات عبر GET /business/hashtag/suggestion/، وهي تأخذ كلمة مفتاحية بإحدى 35 لغة وتعيد 10 هاشتاغات، ولكل منها عدد المنشورات التي تستخدمه، وذلك برمز الوصول (token) الخاص بحساب TikTok. أما الهاشتاغات الرائجة فتأتي من GET /discovery/trending_list/، الذي يرتّب أعلى 200 حسب البلد والصناعة والفترة، ويستخدم token المُعلِن.

يربط easyCoexistence حسابات TikTok عبر TikTok API for Business، فيجلب كودك الخاص اقتراحات الهاشتاغات بواسطة token من get_social_credentials، ويكتبها Claude أو ChatGPT أو ذلك الكود في الوصف، ثم ينشر المنشور أو يجدول نشره عبر publish_tiktok_post، مع مراقبة كل اتصال على مدار الساعة.

35

اللغات التي يقبلها معامل language في نقطة اقتراح الهاشتاغات، والافتراضي en، وتعود الاقتراحات بلغة الكلمة المفتاحية.

40 a minute

عدد الطلبات التي يمكن لحساب مصرّح له أن يرسلها إلى نقطة نهاية واحدة من Accounts API، بما فيها اقتراحات الهاشتاغات.

NEW

قيمة rank_change لهاشتاغ رائج لم يكن ضمن أعلى 200 في الفترة السابقة.

30 days

أطول مدى لـ trending_history، وهو الترتيب اليومي والمشاهدات التي تعيدها TikTok لكل هاشتاغ رائج.

10

أكبر عدد من hashtag_ids يقبله /discovery/video_list/ في استدعاء واحد، فيعيد أعلى 20 فيديو رائجاً لكل منها.

أي نقاط نهاية في TikTok تعيد الهاشتاغات؟

تعيد خمس نقاط نهاية في TikTok API for Business هاشتاغات للمنشورات العضوية، وتنقسم بحسب الرمز الذي تأخذه: رمز حساب TikTok نفسه، أو رمز مُعلِن من حساب إعلاني مصرّح به. وهناك نقطة سادسة ضمن أدوات Marketing API تقترح هاشتاغات لاستهداف الإعلانات بدلاً من ذلك:

/business/hashtag/suggestion/10 hashtags for a keyword, for captions; account token
/discovery/trending_list/Top 200 popular hashtags by country, category and period; advertiser token
/discovery/detail/One popular hashtag's numbers, ad status and viewer ages; advertiser token
/discovery/video_list/Top 20 trending videos for up to 10 popular hashtags; advertiser token
/business/mention/top_hashtag/list/The 20 hashtags used most in posts that @mention the business; account token
/tool/hashtag/recommend/Hashtags to target ads at, under an advertiser_id; not for captions

كيف تستدعي نقطة الاقتراحات؟

بطلب GET يحمل business_id الخاص بالحساب والكلمة المفتاحية، واختيارياً language، ويبلغ عدد قيمه 35 قيمة، تبدأ من en وهي الافتراضية، مروراً بـ es وpt-BR وja-JP، وصولاً إلى zh-Hant-TW، وتطابق TikTok الاقتراحات مع لغة الكلمة المفتاحية. يحمل الترويسة Access-Token رمز حساب TikTok، وتدرج وثائق TikTok API هذه النقطة ضمن صلاحية Video Publish من TikTok Accounts، وهي الصلاحية نفسها التي يستخدمها نشر الفيديو:

Hashtag suggestions for a keyword, after TikTok's own example
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'keyword=summer' \
  --data-urlencode 'language=en'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "suggestions": [
      { "name": "summer", "post_count": 65296335 },
      { "name": "summertime", "post_count": 4787632 },
      { "name": "summeroutfit", "post_count": 2245117 }
    ]
  }
}

ماذا تتضمن كل اقتراح؟

اسماً، والهاشتاغ الذي يُستخدم، وpost_count، أي إجمالي عدد المنشورات التي استخدمته. تعيد TikTok 10 اقتراحات، تأتي فيها المطابقات التامة للكلمة المفتاحية أولاً، ثم الباقي بحسب عدد المنشورات. لا تحمل القائمة بيانات عن الاتجاهات، فارتفاع post_count يدل على هاشتاغ تستخدمه منشورات كثيرة أصلاً، وهذه إشارة تختلف عن الترتيب الصاعد الذي يعرضه /discovery/trending_list/.

أي الرموز والصلاحيات تحتاجها كل نقطة؟

تختلف أكثر مما توحي به المسارات، لذا تحقق منها قبل البناء:

  • /business/hashtag/suggestion/: token حساب TikTok وbusiness_id، مع تطبيق يمتلك صلاحية Video Publish ضمن TikTok Accounts.
  • /discovery/trending_list/ و/discovery/detail/ و/discovery/video_list/: token المُعلِن وadvertiser_id من تفويض الحساب الإعلاني، مع تطبيق يمتلك صلاحية Discovery ضمن Creative Management.
  • /business/mention/top_hashtag/list/: نطاق biz.brand.insights، على حساب يملك Advanced Access أو Verified Business Account.
  • /tool/hashtag/recommend/: token المُعلِن وadvertiser_id، ولا تذكر وثائق TikTok أي صلاحية لها.

ماذا تعيد الهاشتاغات الرائجة؟

يأخذ GET /discovery/trending_list/ المعامل discovery_type بقيمته الوحيدة HASHTAG، مع country_code وcategory_name وdate_range اختيارية، ويقبل category_name صناعةً من المستوى الأول أو الثاني، مثل FOOD_AND_BEVERAGE أو COOKING. ولكل هاشتاغ يعيد:

  • rank_position داخل الفئة، وrank_change مقارنةً بالفترة السابقة: قيمة موجبة عند الصعود، وسالبة عند الهبوط، وNEW إذا لم يكن ضمن أعلى 200.
  • views وposts في البلد والفترة المختارَين، إلى جانب views_global_lifetime وposts_global_lifetime.
  • top_country_list: المواقع الخمسة التي يكون فيها الهاشتاغ الأكثر شعبية.
  • trending_history: حتى 30 يوماً من rank_position_daily وviews_daily، وتكون null إذا لم يكن الهاشتاغ رائجاً في ذلك اليوم أو حصد أقل من 1,000 مشاهدة.

كيف تتعمق في هاشتاغ رائج واحد؟

بطلبين إضافيين بالـ token نفسه للمُعلِن. تأخذ /discovery/detail/ hashtag_id من القائمة، مع country_code وdate_range نفسيهما في استدعاء القائمة، وتضيف hashtag_status، وهي ONLINE إذا كان الهاشتاغ متاحاً لإنشاء الإعلانات، وفئات أعمار المشاهدين في ثلاث مجموعات: 18-24 و25-34 و35+، وتكون فارغة عندما تكون الحالة OFFLINE أو يكون الجمهور المتوقع أقل من 1,000. أما /discovery/video_list/ فيأخذ حتى 10 من hashtag_ids ويعيد أعلى 20 فيديو رائجاً لكل منها، مرتبةً بدرجة تجمع المشاهدات والتعليقات والإعجابات والمشاركات.

كيف يكتب مساعد ذكي وصف منشور بالاقتراحات؟

بخطوة أولى في الكود الخاص بك. لا تجلب أدوات easyCoexistence الاقتراحات، لذا يطلبها كودك من TikTok بواسطة token من get_social_credentials؛ ثم يحتفظ المساعد بما يناسب المنشور، ويكتبها في الوصف مع علامة # وينشره عبر publish_tiktok_post، الآن أو في وقت محدد. وتشير وثائق TikTok للنشر إلى أن الهاشتاغات في الوصف المُرسل عبر API تظهر نصاً عادياً في التطبيق:

1Pick keywordsFrom the post's topic, in the caption's language
2Ask TikTokbusiness/hashtag/suggestion/, from your own code
3ChooseThe names that fit, weighed by post_count
4Write#name in the caption, within 2,200 UTF-16 units on a video
5Publishpublish_tiktok_post, now or with scheduled_at

ما الذي يصل إليه easyCoexistence، وما الذي يقع خارج نطاقه؟

يمنح get_social_credentials الكود الخاص بك token الحساب وbusiness_id لمسارات TikTok التي تبدأ بـ business/، فتعمل اقتراحات الهاشتاغات، وكذلك /business/mention/top_hashtag/list/ حيث تفتح TikTok واجهة Mentions API أمام الحساب. أما نقاط Discovery فخارج النطاق، فهي تأخذ token المُعلِن وadvertiser_id بدلاً من token الحساب. ولا تعيد أدواته المخصصة أي هاشتاغات.

Suggestions, then a scheduled post with them in the caption
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
  ?business_id=<BUSINESS_ID>&keyword=recetas&language=es
Access-Token: <ACCESS_TOKEN>

publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/tortilla.mp4",
  "caption": "Tortilla en 10 minutos #recetas #recetasfaciles #cocina",
  "scheduled_at": "2026-11-12T19:30:00+01:00"
}

الأخطاء الشائعة

  • لصق قيم الأسماء في الوصف كما هي. تعيد أمثلة TikTok الأسماء دون علامة #، فأضفها قبل كل اسم.
  • ترتيب الاقتراحات حسب view_count. حددت TikTok هذا الحقل للإيقاف بحلول 9 أكتوبر 2026، فرتّب حسب post_count.
  • أخذ اقتراح بقيمة post_count تساوي 0 لهاشتاغ مستخدم. تعيد TikTok الكلمة المفتاحية نفسها بهذه الصورة حين لا يكون لديها ما تقترحه.
  • استدعاء /discovery/detail/ بـ country_code أو date_range يختلف عن استدعاء القائمة. تعيد TikTok خطأً، ويعيد الهاشتاغ الذي ليس ضمن القائمة إجابة فارغة.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، وينخفض السعر كلما أضفت اتصالات، مع أول 3 أيام مجانية.

الأسئلة الشائعة

كم عدد الهاشتاغات التي يمكن أن يحملها وصف TikTok عبر API؟

لا تضع وثائق TikTok للنشر حداً منفصلاً للهاشتاغات، فهي تُحسب ضمن الوصف، والحد 2,200 وحدة UTF-16 في منشور الفيديو و4,000 في منشور الصورة، حيث تتوقف الإشارات @ عند 30.

هل يمكن الحصول على اقتراحات هاشتاغات بلغات أخرى؟

نعم. مرّر language مع الكلمة المفتاحية، مثل pt-BR أو es أو ja-JP؛ تتبع الاقتراحات لغة الكلمة المفتاحية، والإنجليزية هي الافتراضية.

هل يمكن لحساب TikTok الحصول على الهاشتاغات الرائجة دون حساب إعلاني؟

لا، ليس من /discovery/trending_list/ الذي يأخذ token المُعلِن. أما الحساب الذي يملك Advanced Access أو Verified Business Account فيمكنه قراءة الهاشتاغات العشرين الأكثر استخداماً في المنشورات التي تذكره.

كم تكلف easyCoexistence لحساب TikTok؟

من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، وينخفض السعر كلما أضفت اتصالات، مع أول 3 أيام مجانية، وكل حساب TikTok يمثل اتصالاً واحداً.

تابع القراءة

حدود تعليقات TikTok عبر API: الطول والوسوم والإشاراتكم يمكن أن يكون تعليق فيديو TikTok عبر API for Business، وكيف تعمل الوسوم والإشارات، ومتى تظهر أسطر الفقرات، وحدود منشورات الصور.هل تستطيع واجهة برمجة التطبيقات (API) من TikTok البحث عن الفيديوهات والوسوم والاتجاهات؟أي واجهة TikTok تبحث عن ماذا: Research API للفيديوهات حسب الكلمة أو الوسم، و Commercial Content API للإعلانات، و API for Business للاتجاهات.جدولة منشورات TikTok عبر واجهة برمجة التطبيقات (API)كيف تُجدول فيديوهات TikTok ومنشورات الصور عبر API: طابور ينشرها في التاريخ والوقت اللذين تحددهما، وفق قواعد TikTok لحظة الإرسال.أفضل وقت للنشر على TikTok، من بيانات واجهة برمجة التطبيقات (API) نفسهااعثر على ساعات النشر الأفضل لحساب TikTok في audience_activity، وهي أعداد المتابعين النشطين في كل ساعة، ثم جدولة المنشورات فيها.إضافة الموسيقى إلى منشورات TikTok عبر APIكيف تضيف واجهة TikTok للأعمال الموسيقى: مقاطع من مكتبة الموسيقى التجارية بالمعرّف، والحجم والتوقيت في الفيديو، وخيار auto_add_music لمنشورات الصور.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في