الكتالوج
الحقول والخيارات
تحتاج بعض الخدمات إلى أكثر من رابط وكمية. تسرد هذه الصفحة كل حقل إضافي وحدوده وكيفية تحديد الكمية وكيفية إرسال تفاعلات Telegram.
كيف تعمل الحقول
تسرد كل خدمة الحقول التي تقبلها في fields (انظر عرض الخدمات). أرسل كل حقل بـ key الخاص به في طلب add نفسه. الحقل من أحد الأنواع أدناه. قائمة الأسطر عنصر واحد في كل سطر، يفصل بينها سطر جديد.
أنواع الحقول
integer- عدد صحيح ضمن الحدود المعروضة.
text- نص قصير حتى الطول المعروض.
lines- قائمة بعنصر واحد في كل سطر. تُحذف الأسطر الفارغة.
choice- قيمة واحدة من قائمة ثابتة.
url- رابط يبدأ بـ
http://أوhttps://. reactions- تفاعلات Telegram، كمزيج أو بأعداد دقيقة. انظر تفاعلات Telegram.
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}الخدمة لا تقبل حقلًا أرسلته. صحّح الطلب أولًا.
- 400
MISSING_PARAMETER
Missing required parameter: {param}معامل مطلوب مفقود. يسمّيه details.param. صحّح الطلب أولًا.
- 400
INVALID_OPTION
Invalid {param}: {rule}قيمة حقل إضافي غير صالحة. يبيّن details.param و details.rule أيّها ولماذا. صحّح الطلب أولًا.
الحقول والكمية حسب نوع الخدمة
يخبرك type_key بالحقول التي يجب إرسالها. الأنواع التي تعمل من قائمة ترسلها (التعليقات المخصصة والردود على التعليقات وقوائم أسماء المستخدمين المخصصة) تحدد الكمية بنفسها: هي عدد الأسطر، وتُرفض quantity المختلفة برمز QUANTITY_MISMATCH. وإذا تركت quantity فستُحسب لك.
| type_key | الحقول | الكمية |
|---|---|---|
| default | – | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| package | – | تحددها الخدمة. اترك الكمية. |
| seo | keywords | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| custom_comments | comments | عدد الأسطر في القائمة. يمكنك ترك الكمية. |
| custom_comments_package | comments | تحددها الخدمة. اترك الكمية. |
| mentions | usernames | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| mentions_with_hashtags | usernames, hashtags | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| mentions_custom_list | usernames | عدد الأسطر في القائمة. يمكنك ترك الكمية. |
| mentions_hashtag | hashtag | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| mentions_user_followers | username | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| mentions_media_likers | media | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| comment_likes | username | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| poll | answer_number | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| comment_replies | comments, username | عدد الأسطر في القائمة. يمكنك ترك الكمية. |
| invites_from_groups | groups | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
| web_traffic | country, device, type_of_traffic, google_keyword, referring_url | أي كمية من الحد الأدنى للخدمة إلى حدها الأقصى، بمضاعفات خطوتها (step). |
key=YOUR_API_KEY&action=add&service=31&link=https://instagram.com/example/p/abc123&comments=Great shot!%0ALove the colors%0ASo clean{
"order": 1234573,
"status": "Pending",
"status_key": "pending",
"charge": "0.27",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}كل الحقول
الأسماء هي أسماء الحقول التي ترسلها. الحقول التي يستخدمها أكثر من نوع لها اسم واحد: username هو كاتب التعليق في الإعجابات والردود على التعليقات، والحساب المستهدف في إشارات المتابعين.
الحقول الإضافية
commentslinesمطلوب- تعليقاتك، تعليق واحد في كل سطر.من 1 إلى 10000 سطرًا، وحتى 500 حرفًا لكل سطر · يستخدمها: custom_comments, custom_comments_package, comment_replies
usernameslinesمطلوب- أسماء المستخدمين المراد ذكرها، اسم واحد في كل سطر. يُحذف الرمز @ في البداية.من 1 إلى 10000 سطرًا، وحتى 64 حرفًا لكل سطر · يستخدمها: mentions, mentions_with_hashtags, mentions_custom_list
hashtagtextمطلوب- الوسم الذي يُستهدف ناشرو منشوراته.حتى 100 حرفًا · يستخدمها: mentions_hashtag
usernametextمطلوب- الحساب الذي يُستهدف متابعوه. اسم مستخدم أو رابط ملف شخصي.حتى 255 حرفًا · يستخدمها: mentions_user_followers
mediaurlمطلوب- المنشور الذي يُستهدف المعجبون به.حتى 2048 حرفًا · يستخدمها: mentions_media_likers
usernametextمطلوب- اسم مستخدم كاتب التعليق.حتى 64 حرفًا · يستخدمها: comment_likes, comment_replies
answer_numberintegerمطلوب- رقم إجابة الاستطلاع التي سيُصوَّت لها.عدد صحيح من 1 إلى 100 · يستخدمها: poll
keywordslinesمطلوب- كلمات البحث المفتاحية، كلمة أو عبارة في كل سطر.من 1 إلى 1000 سطرًا، وحتى 255 حرفًا لكل سطر · يستخدمها: seo
groupslinesمطلوب- روابط المجموعات، رابط واحد في كل سطر.من 1 إلى 1000 سطرًا، وحتى 2048 حرفًا لكل سطر · يستخدمها: invites_from_groups
countrytextاختياري- الدولة كرمز ISO 3166-1 من حرفين، مثل
US.حتى 2 حرفًا · يستخدمها: web_traffic devicechoiceاختياري- نوع الجهاز للزيارات.desktop · android · ios · mobile_mixed · all_mixed · يستخدمها: web_traffic
type_of_trafficchoiceاختياري- مصدر الزيارات. القيمة الافتراضية
direct.google_search · referrer · direct · يستخدمها: web_traffic google_keywordtextحسب نوع الخدمة- كلمة البحث في Google. مطلوبة عندما تكون قيمة
type_of_trafficهيgoogle_search.حتى 255 حرفًا · يستخدمها: web_traffic referring_urlurlحسب نوع الخدمة- الصفحة التي تأتي منها الزيارات. مطلوبة عندما تكون قيمة
type_of_trafficهيreferrer.حتى 2048 حرفًا · يستخدمها: web_traffic reactionsreactionsاختياري- تفاعلات Telegram، كمزيج أو بأعداد دقيقة. انظر تفاعلات Telegram.يستخدمها: الخدمات التي تدرجه في fields
last_postsintegerمطلوب- عدد آخر منشورات القناة التي ستُغطّى. في هذه الخدمات يكون الرابط هو اسم مستخدم القناة.عدد صحيح من 10 إلى 500 · يستخدمها: الخدمات التي تدرجه في fields
تفاعلات Telegram
يقبل Telegram 73 رمزًا تعبيريًا للتفاعل وما لا يزيد على 11 منها مختلفًا في المنشور الواحد. تستقبلها الخدمات التي لها حقل reactions في قيمة نصية واحدة، ويُرفض أي شيء خارج المجموعة المسموح بها قبل أن يُخصم منك أي مبلغ. أرسل الرموز التعبيرية كنص عادي في الطلب.
طريقتان لإرسال التفاعلات
👍,❤️,🔥mix- قائمة من الرموز التعبيرية. نوزّع
quantityعليها، لذا فإنquantityمطلوبة. 👍:60,❤️:40exact- كل رمز تعبيري مع عدده الخاص، وهو عدد صحيح لا يقل عن 1. الكمية هي المجموع، لذا فإن
quantityاختيارية؛ وإن أرسلتها فيجب أن تساوي المجموع.
key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=500&reactions=👍,❤️,🔥{
"order": 1234571,
"status": "Pending",
"status_key": "pending",
"charge": "0.45",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&reactions=👍:60,❤️:40{
"order": 1234572,
"status": "Pending",
"status_key": "pending",
"charge": "0.09",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}التفاعلات المسموح بها وعددها 73
قد تسمح الخدمة بعدد أقل. يسرد حقلها في fields بالضبط ما تقبله ضمن allowed، مع max_distinct وmodes. يُتجاهل محدد التنويع عند المقارنة، فالقلب بوجوده أو بدونه يُحسب الرمز نفسه.
- 👍
- 👎
- ❤️
- 🔥
- 🥰
- 👏
- 😁
- 🤔
- 🤯
- 😱
- 🤬
- 😢
- 🎉
- 🤩
- 🤮
- 💩
- 🙏
- 👌
- 🕊️
- 🤡
- 🥱
- 🥴
- 😍
- 🐳
- ❤️🔥
- 🌚
- 🌭
- 💯
- 🤣
- ⚡
- 🍌
- 🏆
- 💔
- 🤨
- 😐
- 🍓
- 🍾
- 💋
- 🖕
- 😈
- 😴
- 😭
- 🤓
- 👻
- 👨💻
- 👀
- 🎃
- 🙈
- 😇
- 😨
- 🤝
- ✍️
- 🤗
- 🫡
- 🎅
- 🎄
- ☃️
- 💅
- 🤪
- 🗿
- 🆒
- 💘
- 🙉
- 🦄
- 😘
- 💊
- 🙊
- 😎
- 👾
- 🤷♂️
- 🤷
- 🤷♀️
- 😡
أخطاء التفاعلات
- 400
INVALID_OPTION
Invalid {param}: {rule}قيمة حقل إضافي غير صالحة. يبيّن details.param و details.rule أيّها ولماذا. صحّح الطلب أولًا.
- 400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})الكمية لا تطابق عدد العناصر في قائمة أو في حقل التفاعلات. صحّح الطلب أولًا.
- 400
MISSING_PARAMETER
Missing required parameter: {param}معامل مطلوب مفقود. يسمّيه details.param. صحّح الطلب أولًا.
key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=100&reactions=🧿,👍{
"error": "Invalid reactions: unsupported_emoji",
"error_code": "INVALID_OPTION",
"retryable": false,
"details": {
"emoji": "🧿",
"param": "reactions",
"rule": "unsupported_emoji"
}
}كلمات القواعد
يحمل INVALID_PARAMETER وINVALID_OPTION قيمة details.rule قصيرة تبيّن ما الخطأ. تفرّع أولًا حسب error_code، وعامل أي كلمة قاعدة لا تعرفها على أنها قيمة غير صالحة عامة، لأنه قد تُضاف كلمات جديدة.
كلمات القواعد في details.rule
must_be_integer- مطلوب عدد صحيح.
too_small- القيمة أقل من الحد الأدنى المسموح به.
too_large- القيمة أكبر من الحد الأقصى المسموح به.
too_long- النص أطول من المسموح.
bad_format- القيمة ليست بالصيغة المتوقعة.
not_allowed- القيمة ليست من الخيارات المسموح بها.
not_a_url- القيمة ليست رابط http أو https.
too_few_lines- عدد أسطر القائمة أقل من المطلوب.
too_many_lines- عدد أسطر القائمة أكثر من المسموح.
empty- القيمة فارغة.
unsupported_emoji- التفاعل ليس مما تقبله الخدمة. يحدده details.emoji.
too_many_emoji- عدد التفاعلات المختلفة أكبر مما تسمح به الخدمة.
duplicate_emoji- ظهر التفاعل نفسه مرتين.
bad_count- عدد التفاعل ليس عددًا صحيحًا لا يقل عن 1.
mixed_forms- اختلطت تفاعلات بأعداد وتفاعلات بلا أعداد في قيمة واحدة.
line_too_long- سطر أطول من المسموح.
bad_length- النص فارغ أو أطول من المسموح.
iso_country- الدولة ليست رمز ISO 3166-1 من حرفين.
invalid_choice- القيمة ليست من الخيارات المسموح بها.
url- القيمة ليست رابط http أو https.
between_1_and_100- العدد خارج نطاق الحقل. تسمّي الكلمة النطاق، مثل between_1_and_100.
between_10_and_500- العدد خارج نطاق الحقل. تسمّي الكلمة النطاق، مثل between_1_and_100.