# ملفات تعريف مستخدمي Felo على X

POST /api/v1/data/x/user/info

اختر العملية الخاصة بالبيانات التي تحتاجها. تستخدم النقاط الخمس جميعها POST وتعيد JSON في الجذر، من دون غلاف `data` مشترك.

تستخدم جميع الأمثلة `FELO_API_KEY` من [نظرة عامة](https://openapi.felo.ai/ar/docs/data-api/guides/felo-overview.md). تستخدم الاستدعاءات **رصيد المنصة**، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.





## 1. احصل على ملفات تعريف المستخدمين

`POST /api/v1/data/x/user/info`

| الحقل | النوع | مطلوب | المعنى |
|---|---|---|---|
| `usernames` | string array | نعم | من 1 إلى 100 اسم مستخدم؛ أرسل المعرّفات بدون `@` |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/info" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["OpenAI"]}'
```

تحتوي الاستجابة على `users` و`total`. يتضمن كل مستخدم `user_id` و`username` و`display_name`; وقد يظهر أيضًا نص الملف الشخصي، وأعداد المتابعين، وحالة التحقق، وبيانات وصفية أخرى. يمكن أن تُرجع الدفعة أقل من عدد الملفات الشخصية المطلوبة. طابِق باستخدام اسم المستخدم أو المعرف، وليس بحسب موضع المصفوفة.

```json
{"users":[{"user_id":"example-user-id","username":"example","display_name":"Example"}],"total":1}
```



## الترقيم والتحكم في التكلفة

يعدّ `total` المصفوفة المقابلة في الاستجابة الحالية: المنشورات ذات المستوى الأعلى في استعلامات المنشورات، أو الردود داخل كل إدخال نتيجة في استعلامات الردود. وهو ليس عدد المطابقات العالمي، ولا العدد الكامل لردود منشور، ولا العدد النهائي القابل للفوترة.

1. أرسل الطلب الأول بدون `cursor`.
2. اقرأ `has_next` و`next_cursor` من الاستجابة. بالنسبة للردود، اقرأهما في كل إدخال نتيجة.
3. إذا كانت هناك صفحة أخرى وكان المؤشر غير فارغ، فأرسله كما هو مع الاستعلام نفسه. بالنسبة لدفعة ردود، واصل كل منشور على حدة.
4. توقّف عندما لا توجد صفحة تالية، أو عندما يتكرر مؤشر، أو عندما تصل إلى حد الصفحة أو الإنفاق الخاص بك.

تعكس بيانات ترقيم الصفحات آخر استجابة أصلية؛ وقد تُقتطع المجموعة المُعادة عند حد أقصى للنتائج. حتى `has_next=false` ليس ضمانًا بأن كل سجل X أو الردود قد استُرجعت. اعرض العدد الفعلي المُعاد بدلًا من وسم مجموعة نتائج محدودة على أنها كل البيانات المتاحة.

يمكن أن تُفْرض رسوم على كل صفحة ناجحة. تُفوتر هذه العمليات الخمس حسب النتائج المُعادة، وليس برسم ثابت لكل طلب. يمكن للردود المتداخلة والسجلات الأخرى المُعادة أن تؤثر في العدد المُفوتر؛ لا تقدّر التكلفة اعتمادًا على طول المصفوفة ذات المستوى الأعلى فقط. تحقّق من [الأسعار الحالية](https://openapi.felo.ai/api/v1/data/prices) والاستخدام في وحدة التحكم. توجد الحقول الكاملة للكائنات في [مخطط OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).