ردود منشورات Felo على X
المزود: Felo · مدفوع برصيد المنصة
اختر العملية الخاصة بالبيانات التي تحتاجها. تستخدم النقاط الخمس جميعها POST وتعيد JSON في الجذر، من دون غلاف data مشترك.
تستخدم جميع الأمثلة FELO_API_KEY من نظرة عامة. تستخدم الاستدعاءات رصيد المنصة، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.
5. اقرأ الردود
POST /api/v1/data/x/tweet/replies
| الحقل | النوع | مطلوب | المعنى |
|---|---|---|---|
tweet_ids | string or string array | نعم | معرّف منشور واحد أو دفعة تصل إلى 20 معرّفًا |
cursor | string | لا | حتى 4,000 حرف؛ استخدمه مع معرّف منشور واحد |
since_time | integer | لا | وقت البدء بثواني Unix |
until_time | integer | لا | وقت الانتهاء بثواني Unix |
استبدل العنصر النائب بمعرّف منشور حقيقي:
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/tweet/replies" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tweet_ids":["POST_ID"]}'على خلاف الخط الزمني وبحث المنشورات، تُجمَّع الردود تحت results. لكل إدخال حالة ترقيم خاصة به:
{"results":[{"tweet_id":"POST_ID","replies":[],"total":0,"has_next":false,"next_cursor":null}]}حدود الردود لكل طلب
يقرأ كل طلب صفحة ردود أصلية واحدة لكل tweet_id ويحتفظ بما يصل إلى 100 رد؛ ولا يجلب تلقائيًا كل صفحات الردود. في دفعة تصل إلى 20 معرّفًا، ينطبق حد 100 رد بشكل منفصل على كل إدخال في results. قد تكون الأعداد الفعلية أقل.
يمثل total في كل إدخال عدد الردود المُعادة في ذلك الإدخال، وليس العدد الكامل لردود المنشور. للمتابعة، استخدم next_cursor لذلك الإدخال وأرسل فقط معرّف المنشور المفرد الخاص به في الطلب التالي. لا يوجد معامل limit لزيادة الحد الأقصى لكل طلب.
الترقيم والتحكم في التكلفة
يعدّ total المصفوفة المقابلة في الاستجابة الحالية: المنشورات ذات المستوى الأعلى في استعلامات المنشورات، أو الردود داخل كل إدخال نتيجة في استعلامات الردود. وهو ليس عدد المطابقات العالمي، ولا العدد الكامل لردود منشور، ولا العدد النهائي القابل للفوترة.
- أرسل الطلب الأول بدون
cursor. - اقرأ
has_nextوnext_cursorمن الاستجابة. بالنسبة للردود، اقرأهما في كل إدخال نتيجة. - إذا كانت هناك صفحة أخرى وكان المؤشر غير فارغ، فأرسله كما هو مع الاستعلام نفسه. بالنسبة لدفعة ردود، واصل كل منشور على حدة.
- توقّف عندما لا توجد صفحة تالية، أو عندما يتكرر مؤشر، أو عندما تصل إلى حد الصفحة أو الإنفاق الخاص بك.
تعكس بيانات ترقيم الصفحات آخر استجابة أصلية؛ وقد تُقتطع المجموعة المُعادة عند حد أقصى للنتائج. حتى has_next=false ليس ضمانًا بأن كل سجل X أو الردود قد استُرجعت. اعرض العدد الفعلي المُعاد بدلًا من وسم مجموعة نتائج محدودة على أنها كل البيانات المتاحة.
يمكن أن تُفْرض رسوم على كل صفحة ناجحة. تُفوتر هذه العمليات الخمس حسب النتائج المُعادة، وليس برسم ثابت لكل طلب. يمكن للردود المتداخلة والسجلات الأخرى المُعادة أن تؤثر في العدد المُفوتر؛ لا تقدّر التكلفة اعتمادًا على طول المصفوفة ذات المستوى الأعلى فقط. تحقّق من الأسعار الحالية والاستخدام في وحدة التحكم. توجد الحقول الكاملة للكائنات في مخطط OpenAPI.