وثائق API Hop
واجهة بيانات Threads
>-
اقرأ الملفات والمنشورات والردود وإعادة النشر والتعليقات ونتائج البحث عبر 12 نقطة نهاية Threads تتطلب المصادقة.
المصادقة
أرسل مفتاح API Hop API في ترويسة Authorization. يعتمد الوصول على البوابات المفعلة وصلاحيات مفتاح API؛ والوثائق لا تؤكد الإتاحة في الإنتاج.
Authorization: Bearer YOUR_API_KEYالطلبات
استخدم معاملات استعلام GET دون جسم طلب. ترفض الحقول المجهولة أو المكررة أو غير الصحيحة. احتفظ بالمعرفات كسلاسل نصية، بما فيها القيم خارج نطاق الأعداد الصحيحة الآمن في JavaScript. تنتهي مهلة الطلبات بعد 60 ثانية ولا تعاد تلقائيا.
curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "post_id=DPVUglOjOUu"الاستجابات
يحفظ غلاف JSON الأصلي code/data والدقة العددية. يتطلب النجاح code=200 وdata غير null. خطأ الأعمال مع HTTP 200 يعد إخفاقا. تختلف بنية الاستجابة بحسب نقطة النهاية؛ وهذا المثال توضيحي، وليس استجابة مباشرة.
{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}الفوترة
السعر الافتراضي $0.002 (2000 رصيد) لكل طلب ناجح، بما فيه المصفوفات أو الكائنات الفارغة الناجحة، وليس لكل عنصر. لأسعار الحساب الخاصة الأولوية. تحرر طلبات المزود الفاشلة المبلغ المحجوز. تعيد أخطاء التسوية خطأ دون تكرار طلب المزود.
حدود ترقيم الصفحات
لا تدعم منشورات المستخدم وإعادة النشر والردود وتعليقات المنشورات والبحث الأبرز والبحث الحديث ترقيم الصفحات. حقل end_cursor فيها محجوز ولا يؤثر؛ ولا تستخدم next_cursor أو has_more لجلب صفحات إضافية. تعيد قوائم المستخدمين الدفعة المتاحة فقط (نحو 25 عنصرا)، وليس السجل الكامل. لا تجلب أي نقطة نهاية بيانات إضافية تلقائيا.
الأخطاء
HTTP 400: معاملات غير صحيحة؛ 401: إخفاق المصادقة؛ 402: رصيد غير كاف؛ 403: رفض الوصول؛ 405: طريقة غير مدعومة؛ 408: إلغاء؛ 429: حد المعدل؛ 5xx: إخفاق الخدمة أو المزود، بما فيه انتهاء المهلة 504. احتفظ بـX-Request-Id للتشخيص.
المرجع
المصادر
جرى التحقق مقابل OpenAPI V5.3.2 الرسمي وأسعار نقاط النهاية في 2026-10-31. استبعدت العملية fetch_post_id_from_url الموجودة في الأسعار فقط لأنها غير موجودة في OpenAPI.