مرجع واجهة برمجة التطبيقات
نظرة عامة
تتيح لك واجهة SNSTracker API إدارة خلاصات المراقبة والقنوات برمجيًا. يمكنك إنشاء الخلاصات (الفيديوهات، المنشورات، إلخ) والقنوات (الحسابات، الملفات الشخصية)، وتحديثها للحصول على أحدث البيانات، واستلام إشعارات فورية عبر webhooks.
المصادقة
تتطلب جميع طلبات API المصادقة باستخدام مفتاح API. أدرج مفتاحك في ترويسة X-API-Key.
كيفية الحصول على مفتاح API الخاص بك:
- سجّل الدخول إلى SNSTracker
- اذهب إلى Settings → API Keys
- أنشئ مفتاح API جديدًا أو استخدم مفتاحًا موجودًا
- انسخ مفتاح API (ستراه مرة واحدة فقط عند إنشائه)
نقاط نهاية API
1. إنشاء الخلاصات
أنشئ خلاصات مراقبة عبر إرسال روابط الخلاصات (فيديوهات، منشورات، إلخ).
POST /api/v1/feedsالطلب
الترويسات:
X-API-Key: مفتاح API الخاص بك (مطلوب)Content-Type:application/json
جسم الطلب:
{
"urls": [
"https://www.tiktok.com/@user/video/1234567890",
"https://www.instagram.com/p/ABC123/"
],
"collectionId": "coll_abc123xyz"
}المعلمات:
urls(مطلوب): مصفوفة روابط خلاصات للمراقبة. الحد الأقصى 200 رابطًا لكل طلب.collectionId(اختياري): معرف المجموعة التي ستُضاف إليها الخلاصات. إذا لم يُقدَّم، فسيتم استخدام المجموعة الافتراضية لفريقك.
الاستجابة
استجابة ناجحة (200):
{
"code": 0,
"message": "ok",
"data": {
"success": 2,
"failed": 0,
"total": 2,
"results": [
{
"index": 0,
"url": "https://www.tiktok.com/@user/video/1234567890",
"platform": "tiktok",
"feedId": "feed_abc123xyz",
"success": true
},
{
"index": 1,
"url": "https://www.instagram.com/p/ABC123/",
"platform": "instagram",
"feedId": "feed_def456uvw",
"success": true
}
],
"errors": [],
"message": "تم إنشاء الخلاصات بنجاح. سيتم تحديث البيانات قريبًا."
}
}حقول الاستجابة:
success: عدد الخلاصات التي تم إنشاؤها بنجاحfailed: عدد عمليات إنشاء الخلاصات الفاشلةtotal: إجمالي عدد الروابط المقدمةresults: مصفوفة النتائج لكل رابطindex: الفهرس الصفري في مصفوفة الطلبurl: الرابط الذي تم التحقق منه وتوحيدهplatform: المنصة المكتشفة (tiktok، instagram، youtube، إلخ)feedId: المعرف الفريد للخلاصة المُنشأةsuccess: هل تم إنشاء الخلاصة بنجاحskipped: (اختياري) هل تم تخطي الخلاصة لأنها موجودة مسبقًاresumed: (اختياري) هل تم استئناف خلاصة متوقفةerror: (اختياري) رسالة خطأ إذا فشل الإنشاء
errors: مصفوفة الأخطاء للروابط الفاشلة
مثال على الطلب
curl -X POST https://snstracker.com/api/v1/feeds \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.tiktok.com/@user/video/1234567890"
]
}'2. تحديث الخلاصات
حدّث الخلاصات الموجودة للحصول على أحدث البيانات فورًا. يمكن تحديث الخلاصات ذات الحالة "Pending" أو "Tracked" فقط.
POST /api/v1/feeds/refreshالطلب
الترويسات:
X-API-Key: مفتاح API الخاص بك (مطلوب)Content-Type:application/json
جسم الطلب:
{
"feedIds": ["feed_abc123xyz", "feed_def456uvw"]
}المعلمات:
feedIds(مطلوب): مصفوفة معرفات الخلاصات المطلوب تحديثها
الاستجابة
استجابة ناجحة (200):
{
"code": 0,
"message": "ok",
"data": {
"success": true,
"feedIds": ["feed_abc123xyz", "feed_def456uvw"],
"total": 2,
"message": "تم تحديث 2 خلاصة بنجاح"
}
}حقول الاستجابة:
success: ما إذا كانت عملية التحديث ناجحةfeedIds: مصفوفة معرفات الخلاصات التي تم تحديثهاtotal: عدد الخلاصات التي تم تحديثهاmessage: رسالة نجاح
مثال على الطلب
curl -X POST https://snstracker.com/api/v1/feeds/refresh \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"feedIds": ["feed_abc123xyz"]
}'3. إنشاء القنوات
أنشئ قنوات مراقبة عبر إرسال روابط القنوات (ملفات الحسابات، إلخ).
Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.
POST /api/v1/channelsالطلب
الترويسات:
X-API-Key: مفتاح API الخاص بك (مطلوب)Content-Type:application/json
جسم الطلب:
{
"urls": [
"https://www.tiktok.com/@username",
"https://www.instagram.com/username/"
],
"collectionId": "coll_abc123xyz"
}المعلمات:
urls(مطلوب): مصفوفة روابط القنوات للمراقبة. الحد الأقصى 5 روابط لكل طلب.collectionId(اختياري): معرف المجموعة التي ستُضاف إليها القنوات. إذا لم يُقدَّم، فسيتم استخدام المجموعة الافتراضية لفريقك.
الاستجابة
استجابة ناجحة (200):
{
"code": 0,
"message": "ok",
"data": {
"success": 2,
"failed": 0,
"total": 2,
"results": [
{
"index": 0,
"url": "https://www.tiktok.com/@username",
"platform": "tiktok",
"channelId": "channel_abc123xyz",
"success": true
},
{
"index": 1,
"url": "https://www.instagram.com/username/",
"platform": "instagram",
"channelId": "channel_def456uvw",
"success": true
}
],
"errors": [],
"message": "تم إنشاء القنوات بنجاح. سيتم تحديث البيانات قريبًا."
}
}حقول الاستجابة:
success: عدد القنوات التي تم إنشاؤها بنجاحfailed: عدد عمليات إنشاء القنوات الفاشلةtotal: إجمالي عدد الروابط المقدمةresults: مصفوفة النتائج لكل رابطindex: الفهرس الصفري في مصفوفة الطلبurl: الرابط الذي تم التحقق منه وتوحيدهplatform: المنصة المكتشفة (tiktok، instagram، youtube، إلخ)channelId: المعرف الفريد للقناة المُنشأةsuccess: هل تم إنشاء القناة بنجاحskipped: (اختياري) هل تم تخطي القناة لأنها موجودة مسبقًاresumed: (اختياري) هل تم استئناف قناة متوقفةerror: (اختياري) رسالة خطأ إذا فشل الإنشاء
errors: مصفوفة الأخطاء للروابط الفاشلة
مثال على الطلب
curl -X POST https://snstracker.com/api/v1/channels \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.tiktok.com/@username"
]
}'4. تحديث القنوات
حدّث القنوات الموجودة للحصول على أحدث البيانات فورًا. يمكن تحديث القنوات ذات الحالة "Pending" أو "Tracked" فقط.
Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.
POST /api/v1/channels/refreshالطلب
الترويسات:
X-API-Key: مفتاح API الخاص بك (مطلوب)Content-Type:application/json
جسم الطلب:
{
"channelIds": ["channel_abc123xyz", "channel_def456uvw"]
}المعلمات:
channelIds(مطلوب): مصفوفة معرفات القنوات المطلوب تحديثها
الاستجابة
استجابة ناجحة (200):
{
"code": 0,
"message": "ok",
"data": {
"success": true,
"channelIds": ["channel_abc123xyz", "channel_def456uvw"],
"total": 2,
"message": "تم تحديث 2 قناة بنجاح"
}
}حقول الاستجابة:
success: ما إذا كانت عملية التحديث ناجحةchannelIds: مصفوفة معرفات القنوات التي تم تحديثهاtotal: عدد القنوات التي تم تحديثهاmessage: رسالة نجاح
مثال على الطلب
curl -X POST https://snstracker.com/api/v1/channels/refresh \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"channelIds": ["channel_abc123xyz"]
}'5. مزامنة الخلاصة
قم بمزامنة بيانات الخلاصة مباشرةً من خدمة scrapy. يجلب هذا الطرف أحدث بيانات الخلاصة فورًا ويستهلك أرصدة عند نجاح المزامنة. يشترك جميع أعضاء الفريق ومفاتيح API في حد واحد لجميع واجهات المزامنة. الحد المشترك هو 1 لستارتر أو دون اشتراك ساري، و5 لستاندرد، و10 لبريميوم.
⚠️ ملاحظة مهمة: نقطة المزامنة هذه مستقلة ولا تتكامل مع منصة الويب. عمليات المزامنة:
- لن تنشئ أو تحدّث سجلات الخلاصات في لوحة التحكم على الويب
- لن تظهر في قائمة خلاصاتك أو مجموعاتك
- لن تُفعّل webhooks أو الإشعارات
- ستقوم فقط بإرجاع البيانات التي تم جلبها مباشرةً في استجابة API
تم تصميم هذه النقطة لجلب البيانات لمرة واحدة عبر API. لإنشاء خلاصات مراقبة دائمة تظهر في منصة الويب، استخدم نقطة إنشاء الخلاصات بدلًا من ذلك.
POST /api/v1/feeds/syncالطلب
الترويسات:
X-API-Key: مفتاح API الخاص بك (مطلوب)Content-Type:application/json
جسم الطلب:
{
"url": "https://www.tiktok.com/@user/video/1234567890"
}المعلمات:
url(مطلوب): رابط الخلاصة للمزامنة. يجب أن يكون سلسلة صحيحة وغير فارغة.
الاستجابة
استجابة ناجحة (200):
{
"code": 0,
"message": "ok",
"data": {
"success": true,
"url": "https://www.tiktok.com/@user/video/1234567890",
"feedInfo": {
"feed_id": "1234567890",
"platform": 1,
"platform_name": "tiktok",
"url": "https://www.tiktok.com/@user/video/1234567890",
"views": 1000000,
"likes": 200000,
"comments": 1000,
"shares": 2000,
"bookmarks": 200,
"engagement": 512000,
"description": "وصف الفيديو",
"hashtags": ["tag1", "tag2"],
"publish_at": 1234567890
}
}
}حقول الاستجابة:
success: ما إذا كانت عملية المزامنة ناجحةurl: رابط الخلاصة الذي تمت مزامنتهfeedInfo: معلومات الخلاصة الكاملة بما في ذلك المقاييس والوصف والوسوم، إلخ.
استجابات الخطأ:
429 Too Many Requests: تم بلوغ حد التزامن المشترك للفريق. لا تتم إضافة الطلب إلى قائمة انتظار.400 Bad Request: رصيد غير كافٍ أو رابط غير صالح
مثال على الطلب
curl -X POST https://snstracker.com/api/v1/feeds/sync \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.tiktok.com/@user/video/1234567890"
}'6. مزامنة القناة
قم بمزامنة بيانات القناة مباشرةً من خدمة scrapy. يجلب هذا الطرف أحدث بيانات القناة فورًا ويستهلك أرصدة عند نجاح المزامنة. يشترك جميع أعضاء الفريق ومفاتيح API في حد واحد لجميع واجهات المزامنة. الحد المشترك هو 1 لستارتر أو دون اشتراك ساري، و5 لستاندرد، و10 لبريميوم.
Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.
⚠️ ملاحظة مهمة: نقطة المزامنة هذه مستقلة ولا تتكامل مع منصة الويب. عمليات المزامنة:
- لن تنشئ أو تحدّث سجلات القنوات في لوحة التحكم على الويب
- لن تظهر في قائمة قنواتك أو مجموعاتك
- لن تُفعّل webhooks أو الإشعارات
- ستقوم فقط بإرجاع البيانات التي تم جلبها مباشرةً في استجابة API
تم تصميم هذه النقطة لجلب البيانات لمرة واحدة عبر API. لإنشاء قنوات مراقبة دائمة تظهر في منصة الويب، استخدم نقطة إنشاء القنوات بدلًا من ذلك.
POST /api/v1/channels/syncالطلب
الترويسات:
X-API-Key: مفتاح API الخاص بك (مطلوب)Content-Type:application/json
جسم الطلب:
{
"url": "https://www.tiktok.com/@username"
}المعلمات:
url(مطلوب): رابط القناة للمزامنة. يجب أن يكون سلسلة صحيحة وغير فارغة.
الاستجابة
استجابة ناجحة (200):
{
"code": 0,
"message": "ok",
"data": {
"success": true,
"url": "https://www.tiktok.com/@username",
"channelInfo": {
"id": "1234567890",
"platform": 1,
"platform_name": "tiktok",
"username": "username",
"nickname": "اسم المستخدم",
"description": "وصف القناة",
"followers": 1000000,
"followings": 2000,
"likes": 200000000,
"total_count": 1000,
"track_count": 1000,
"status": 1
}
}
}حقول الاستجابة:
success: ما إذا كانت عملية المزامنة ناجحةurl: رابط القناة الذي تمت مزامنتهchannelInfo: معلومات القناة الكاملة بما في ذلك المقاييس والوصف، إلخ.
استجابات الخطأ:
429 Too Many Requests: تم بلوغ حد التزامن المشترك للفريق. لا تتم إضافة الطلب إلى قائمة انتظار.400 Bad Request: رصيد غير كافٍ أو رابط غير صالح
مثال على الطلب
curl -X POST https://snstracker.com/api/v1/channels/sync \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.tiktok.com/@username"
}'7. مزامنة محتوى القناة
يعيد صفحة واحدة بحد أقصى 12 عنصرًا لكل طلب في Instagram وReels، دون جلب صفحات إضافية تلقائيًا. يعيد instagram منشورات الصور والفيديو والألبومات، ويعيد reels فيديوهات Reels.
POST /api/v1/channels/feeds/sync
X-API-Key: your-api-key
Content-Type: application/jsonRequest and pagination
{
"platform": "instagram",
"channel_name": "instagram"
}countعدد صحيح موجب اختياري يحدد العدد المطلوب من العناصر في هذه الصفحة، دون قيمة افتراضية. تختلف الحدود حسب المنصة: يعيد Instagram وReels ما يصل إلى 12 عنصرًا لكل طلب، وقد يكون العدد أقل. عند إغفاله يُستخدم حجم الصفحة الافتراضي للمنصة.- احذف
cursorللصفحة الأولى. للصفحة التالية أرسلnext_cursorالسابق كما هو مع نفسplatformوchannel_name. عند النهاية:has_more=falseوnext_cursor=null.
{
"platform": "instagram",
"channel_name": "instagram",
"cursor": "previous-next-cursor"
}تكلفة كل صفحة ناجحة 10 أرصدة، بما فيها الصفحات الفارغة. الطلبات الفاشلة فقط مجانية؛ يلزم رصيد 10 على الأقل قبل الطلب. يشترك هذا الطلب في حد الفريق مع واجهات المزامنة الأخرى ولا ينشئ سجلات في لوحة التحكم.
Response example (placeholder cursor) — reels, lunacut.edit, count=1
{
"code": 0,
"message": "ok",
"data": {
"success": true,
"platform": "reels",
"channel_name": "lunacut.edit",
"channel_url": "https://www.instagram.com/lunacut.edit/",
"requested_count": 1,
"returned_count": 1,
"has_more": true,
"next_cursor": "cursor-from-response",
"items": [
{
"feed_id": "4009169989985582972",
"platform": 5,
"platform_name": "reels",
"type": "video",
"url": "https://www.instagram.com/reel/Dejbt1JPz98/",
"author_username": "lunacut.edit",
"publish_at": 1792150387,
"duration": 70.077,
"view_count": 310475
}
]
}
}platform and channel_name are required. channel_name is the username, not the display name; leading @ is accepted and dots are preserved. requested_count is null when count is omitted; returned_count equals items.length. Unknown metrics/timestamps are null. Posts may lack timestamps and carousel details. items uses the existing feed fields, including video_url, image_urls and cover_url; the example shows only selected fields. publish_at is Unix seconds and duration is seconds. Upstream order is preserved, without a most-popular sorting option; deduplicate across pages by feed_id. Empty pages can still have a next cursor; a carousel counts as one post.
تعتمد المقاييس في items، مثل المشاهدات (view_count) والإعجابات (like_count) وعمليات الحفظ (bookmark_count) والتعليقات (comment_count)، على المنصة وبيانات قائمة المحتوى التي توفرها. قد لا تتوفر بعض المقاييس. تُعاد المقاييس غير المتاحة بقيمة null، وهذا لا يعني أن قيمتها صفر.
للاستعلام عن المقاييس الناقصة، استدعِ POST /api/v1/feeds/sync بشكل منفصل، وضع url الخاص بالعنصر في حقل url في جسم الطلب. تُحتسب تكلفة طلب التفاصيل بشكل مستقل وفق قواعد تلك الواجهة. تظل النتائج مرتبطة بالبيانات التي توفرها المنصة، ولا يُضمن الحصول على جميع المقاييس الناقصة.
HTTP: 400 invalid input/cursor or insufficient initial credits; 401 invalid API key; 403 disabled team or inaccessible channel; 402 insufficient credits at settlement; 429 team concurrency limit (Retry-After: 1); 502 upstream/invalid page; 503 service unavailable; 504 timeout.
8. جلب معلومات إضافية للملف الشخصي
POST /api/v1/channels/about/syncيدعم Instagram وReels فقط. الإدخال هو url المطلوب نفسه في /api/v1/channels/sync: استخدم https://www.instagram.com/lunacut.edit/ أو https://www.instagram.com/lunacut.edit/reels/. لا يلزم platform أو count أو cursor. روابط المنشورات والمنصات الأخرى غير مدعومة.
curl -X POST https://snstracker.com/api/v1/channels/about/sync \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.instagram.com/lunacut.edit/"}'كل طلب ناجح يكلف 80 رصيدًا حتى عندما تكون الحقول null. لا تُحتسب الطلبات الفاشلة؛ يلزم رصيد 80 قبل الطلب. حد التزامن مشترك بين جميع واجهات المزامنة للفريق: Starter/دون اشتراك نشط 1، Standard 5، Premium 10. لا تُنشأ سجلات في لوحة التحكم ولا تُرسل webhooks.
مثال للاستجابة؛ توفر الحقول يعتمد على المعلومات العامة للحساب.
{
"code": 0,
"message": "ok",
"data": {
"success": true,
"url": "https://www.instagram.com/lunacut.edit/",
"channelAbout": {
"platform": 6,
"platform_name": "instagram",
"username": "lunacut.edit",
"channel_url": "https://www.instagram.com/lunacut.edit/",
"country": "Brazil",
"country_visible": true,
"date_joined": "2020-05",
"date_joined_text": "May 2020"
}
}
}country: البلد/المنطقة المعلنة فقط عند country_visible=true، وليست موقع IP الآني. country_visible: حالة الظهور أو null إذا كانت مجهولة. date_joined: شهر الانضمام بصيغة YYYY-MM أو null عند الغياب أو تعذر التفسير. date_joined_text: نص التاريخ الأصلي أو null. لا يشمل النبذة أو عدد المتابعين أو الأسماء السابقة.
400 / 401 / 402 / 403 / 429 (Retry-After: 1) / 502 / 503 / 504.
تكامل Webhook
يدعم SNSTracker webhooks لتلقي إشعارات فورية عندما يصل المحتوى المراقَب إلى العتبات التي قمت بإعدادها. يمكنك تهيئة webhooks لتلقي إشعارات حول:
- تحديثات الخلاصة: عندما تزداد المشاهدات أو التفاعل (الإعجابات + التعليقات + المشاركات) بحسب عتبتك
- تحديثات القناة: عندما يزداد عدد المتابعين أو المتابَعين أو الإعجابات بحسب عتبتك
إعداد Webhooks
- تهيئة أهداف webhook في إعدادات المجموعات لديك
- تمكين الإشعارات في إعدادات المجموعة
- تحديد العتبات للمقاييس التي تريد مراقبتها
للحصول على تعليمات تفصيلية لإعداد webhook، يرجى الرجوع إلى دليل إعداد Webhook.
استجابات الخطأ
قد تعيد جميع نقاط النهاية استجابات الأخطاء التالية:
401 غير مصرح - مفتاح API مفقود
{
"code": -1,
"message": "X-API-Key header is required"
}401 غير مصرح - مفتاح API غير صالح
{
"code": -1,
"message": "Invalid API key"
}400 طلب غير صالح - إدخال غير صالح
{
"code": -1,
"message": "Invalid request: urls must be an array"
}400 طلب غير صالح - عدد روابط كبير جدًا (إنشاء الخلاصات)
{
"code": -1,
"message": "Maximum 200 URLs allowed per request"
}400 طلب غير صالح - عدد روابط كبير جدًا (إنشاء القنوات)
{
"code": -1,
"message": "Maximum 200 URLs allowed per request"
}400 طلب غير صالح - رصيد غير كافٍ
{
"code": -1,
"message": "Insufficient credits. Required: 10, Available: 5"
}429 Too Many Requests - حد المزامنة المتزامنة للفريق
{
"code": -1,
"message": "Maximum concurrent sync requests (1) reached for this team. Currently active: 1. Wait for a request to complete, or contact official support to increase the limit."
}403 ممنوع - مجموعة غير صالحة
{
"code": -1,
"message": "Collection not found or does not belong to your team"
}404 غير موجود
{
"code": -1,
"message": "No feeds found"
}أو
{
"code": -1,
"message": "No channels found"
}أمثلة الاستخدام
مثال Python - إنشاء الخلاصات
import requests
url = "https://snstracker.com/api/v1/feeds"
headers = {
"X-API-Key": "your-api-key-here",
"Content-Type": "application/json"
}
data = {
"urls": [
"https://www.tiktok.com/@user/video/1234567890",
"https://www.instagram.com/p/ABC123/"
]
}
response = requests.post(url, json=data, headers=headers)
result = response.json()
if result["code"] == 0:
print(f"Successfully created {result['data']['success']} feeds")
for feed in result["data"]["results"]:
print(f" - {feed['url']}: {feed['feedId']}")
else:
print(f"Error: {result['message']}")مثال JavaScript - تحديث الخلاصات
const response = await fetch('https://snstracker.com/api/v1/feeds/refresh', {
method: 'POST',
headers: {
'X-API-Key': 'your-api-key-here',
'Content-Type': 'application/json',
},
body: JSON.stringify({
feedIds: ['feed_abc123xyz', 'feed_def456uvw'],
}),
});
const result = await response.json();
if (result.code === 0) {
console.log(`Successfully refreshed ${result.data.total} feeds`);
result.data.feedIds.forEach((feedId) => {
console.log(` - ${feedId}`);
});
} else {
console.error(`Error: ${result.message}`);
}ملاحظات مهمة
-
التحقق من الروابط: يتم التحقق من جميع الروابط تلقائيًا قبل الإنشاء. سيتم رفض الروابط غير الصالحة.
-
العناصر المكررة: إذا كان عنصر بنفس الرابط موجودًا بالفعل في المجموعة:
- إذا كان نشطًا، فسيتم تخطيه (مميز بـ
skipped: true) - إذا كان متوقفًا، فسيتم استئنافه (مميز بـ
resumed: true)
- إذا كان نشطًا، فسيتم تخطيه (مميز بـ
-
جمع البيانات: بعد الإنشاء بنجاح، يتم إدراج العناصر في قائمة انتظار لجمع البيانات. ستكون البيانات متاحة بعد وقت قصير من الإنشاء.
-
حالة التحديث: يمكن تحديث العناصر ذات الحالة "Pending" أو "Tracked" فقط. سيتم استبعاد العناصر ذات الحالات الأخرى.
-
الأرصدة: تأكد من توفر أرصدة كافية قبل إرسال الطلبات. عمليات المزامنة تستهلك الأرصدة فور استرجاع البيانات بنجاح. Xiaohongshu channel tasks are priced separately and currently cost 10 credits per successful request.
/api/v1/channels/feeds/sync: تكلفة كل صفحة ناجحة 10 أرصدة، بما فيها الصفحات الفارغة. الطلبات الفاشلة فقط مجانية؛ يلزم رصيد 10 على الأقل قبل الطلب. يشترك هذا الطلب في حد الفريق مع واجهات المزامنة الأخرى ولا ينشئ سجلات في لوحة التحكم./api/v1/channels/about/sync: كل طلب ناجح يكلف 80 رصيدًا حتى عندما تكون الحقولnull. لا تُحتسب الطلبات الفاشلة؛ يلزم رصيد 80 قبل الطلب. حد التزامن مشترك بين جميع واجهات المزامنة للفريق: Starter/دون اشتراك نشط 1، Standard 5، Premium 10. لا تُنشأ سجلات في لوحة التحكم ولا تُرسل webhooks. -
حد المزامنة المتزامنة للفريق (
/api/v1/feeds/sync+/api/v1/channels/sync+/api/v1/channels/feeds/sync+/api/v1/channels/about/sync): يشترك جميع أعضاء الفريق ومفاتيح API في حد واحد لجميع واجهات المزامنة. الحد المشترك هو 1 لستارتر أو دون اشتراك ساري، و5 لستاندرد، و10 لبريميوم. يتبع الحد الاشتراك الساري حاليًا؛ وإذا حدد الدعم الرسمي إعدادًا خاصًا للفريق، تكون له الأولوية. لزيادة حد الفريق، تواصل مع الدعم الرسمي. -
المزامنة مقابل الإنشاء: نقاط المزامنة (
/api/v1/feeds/syncو/api/v1/channels/sync+/api/v1/channels/feeds/sync+/api/v1/channels/about/sync) مستقلة ولا تتكامل مع منصة الويب. تعيد البيانات فقط في استجابة API ولا تنشئ سجلات في لوحة التحكم. لإنشاء عناصر مراقبة دائمة تظهر في منصة الويب، استخدم نقاط الإنشاء (/api/v1/feedsو/api/v1/channels) بدلًا من ذلك. -
إعادة المحاولة: بعد 429، انتظر انتهاء طلب نشط ثم أعد المحاولة بفواصل متزايدة مع الالتزام بترويسة
Retry-After. بعد 503، أعد المحاولة لاحقًا. -
المنصات المدعومة: TikTok و Instagram و YouTube ومنصات تواصل اجتماعي رئيسية أخرى.
استكشاف الأخطاء وإصلاحها
المشكلة: "X-API-Key header is required"
الحل: تأكد من تضمين ترويسة X-API-Key في طلبك.
المشكلة: "Invalid API key"
الحل: تحقق من صحة مفتاح API. يمكنك إنشاء مفتاح جديد من Settings → API Keys.
المشكلة: "Maximum URLs allowed per request"
الحل: قسّم روابطك إلى عدة طلبات. الخلاصات تسمح حتى 200 رابطًا، والقنوات تسمح حتى 5 روابط لكل طلب.
المشكلة: "No collection found"
الحل: أنشئ مجموعة أولًا في لوحة التحكم، أو حدّد معرف مجموعة موجود.
المشكلة: "Insufficient credits"
الحل: اشترِ المزيد من الأرصدة أو تحقق من خطة اشتراكك.
المشكلة: "No refreshable items found"
الحل: يمكن تحديث العناصر ذات الحالة "Pending" أو "Tracked" فقط. تحقق من حالة عناصرِك.
المشكلة: فشل التحقق من بعض الروابط
الحل: تحقق من مصفوفة errors في الاستجابة لمعرفة رسائل الخطأ المحددة. تأكد من أن الروابط من منصات مدعومة ومتاحة للعامة.