Twitter API

Twitter API: البحث عن المستخدمين والجداول الزمنية وتقسيم الصفحات

ادمج نقاط نهاية Twitter / X في API Hop مع مصادقة Bearer واختيار حقول المستخدم والتغريدة وتقسيم الصفحات بالمؤشر ومعالجة أخطاء التحقق.

حوّل اسم المستخدم إلى معرّفه واجلب جدوله الزمني ومرر رمز الصفحة التالية المعاد لطلب صفحة أخرى. تعيد الاستدعاءات الناجحة JSON مباشرة؛ ولا تتطلب هذه النقاط استطلاع Jobs.

الحصول على مفتاح API استكشاف دليل API

مصمم لمهمة محددة

نفّذ عمليات GET الثلاث المدعومة وعالج نتائجها.

ابحث عن حساب باسم المستخدم وحدد حقول الملف الشخصي المطلوب إعادتها.

حدّث حسابا معروفا بمعرّف المستخدم دون بحث آخر بالاسم.

استرجع صفحات الجدول الزمني مع حد لحجم الصفحة ورمز للانتقال بين الصفحات.

وحدة الفوترة

تعرّف على كيفية قياس الاستخدام

بعملة USD لكل طلب.

الحدود التشغيلية

تعتمد الحقول المعادة على معلمات الاستعلام الموثقة واستجابة المزوّد.
يجب أن تكون max_results عددا صحيحا من 1 إلى 100. قد تحتوي الصفحة على نتائج أقل.
احتفظ بمعرّفات المستخدمين والتغريدات كسلاسل نصية لتجنب فقدان الدقة العددية.

أدلة التكامل

اختر خطوتك التالية

خطط للتحديثات والتخزين ضع حدودا لأعداد الطلبات وأزل تكرار المنشورات وسجل أوقات الاسترجاع في تطبيقك. دليل واجهات البيانات راجع منتجات البيانات والعمليات والأسعار الحالية القائمة على الطلبات.

تغطية الدليل الحالية

واجهات API المتاحة ووحدات الفوترة

قارن معرّفات API والعمليات والمزوّدين والأسعار. تحقق من تاريخ الدليل ووحدة فوترة كل عملية قبل تقدير تكاليف الاستخدام.

واجهة بيانات API

Twitter User Data

twitter-user-data الوثائق

نشط

استرجع الملفات الشخصية العامة والجداول الزمنية للمستخدمين على Twitter / X.

المزوّد: Twitter / X Data
وحدة الفوترة: طلب
تنسيقات API ونقاط النهاية: راجع العمليات أدناه لمعرفة نقاط نهاية الطلبات.
القدرات المنشورة: البحث عن مستخدم, الجدول الزمني للمستخدم

العمليات المنشورة

GET /v1/twitter/users جلب مستخدم باسم المستخدم
GET /v1/twitter/users/{id} جلب مستخدم بالمعرّف ID
GET /v1/twitter/users/{id}/tweets جلب منشورات المستخدم

سعر API Hop

الطلب: $0.0020 /طلب

جلب مستخدم باسم المستخدم

GET /v1/twitter/users

سعر API Hop

الطلب: $0.0020 /طلب

جلب مستخدم بالمعرّف ID

GET /v1/twitter/users/{id}

سعر API Hop

الطلب: $0.0020 /طلب

جلب منشورات المستخدم

GET /v1/twitter/users/{id}/tweets

سعر API Hop

الطلب: $0.0020 /طلب

فتح دليل API الكامل

مثال طلب

ابدأ بالعملية الموثقة

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

استخدم عنوان API الأساسي الوارد في وثائق حسابك واستبدل العناصر النائبة في المثال. أرسل مفتاح API في ترويسة Authorization؛ ولا تضعه مطلقا في URL أو ملف مضاف إلى المستودع.

نقاط النهاية

ثلاث عمليات للحسابات والجداول الزمنية

البحث باسم المستخدم GET /v1/twitter/users?username=<USERNAME>

اقرأ data.id المعاد كسلسلة نصية للطلبات اللاحقة.

البحث بمعرّف المستخدم GET /v1/twitter/users/<USER_ID>

استرجع حسابا معروفا واختر حقول ملفه الشخصي اختياريا.

الجدول الزمني للمستخدم GET /v1/twitter/users/<USER_ID>/tweets

اضبط max_results ومرر pagination_token للصفحات اللاحقة.

معلمات الاستعلام

اختيار الحقول وتقسيم الجدول الزمني إلى صفحات

البحث عن حساب: يلزم username في /v1/twitter/users. تقبل نقطتا البحث قائمة user.fields مفصولة بفواصل، مثل description,public_metrics.
حجم الصفحة: تقبل max_results أعدادا صحيحة من 1 إلى 100. وهي حد أعلى لحجم الصفحة وليست ضمانا لذلك العدد من المنشورات.
حقول الجدول الزمني: استخدم tweet.fields=created_at,public_metrics للطوابع الزمنية والمقاييس. اطلب expansions=author_id مع user.fields عند الحاجة إلى تفاصيل الكاتب المتاحة. استخدم exclude=replies,retweets لاستبعاد هذين النوعين من المنشورات.
الصفحة التالية: مرر meta.next_token من الاستجابة كقيمة pagination_token في الطلب التالي. تعامل مع الرمز كقيمة معتمة وطبّق عليه ترميز URL. توقف عندما لا يُعاد رمز تال أو تبلغ ميزانية الصفحات أو يتكرر رمز.

معالجة الاستجابات

قراءة نتائج JSON مباشرة

تعيد عمليات البحث عن المستخدم الحساب في data. تحتوي استجابات الجدول الزمني على مصفوفة data وmeta.result_count، مع meta.next_token عند توفر مؤشر آخر. قد تظهر تفاصيل الكاتب الموسعة في includes.users.

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

استجابة توضيحية لجدول زمني فارغ وليست نتيجة حساب حي. قد تغيب الحقول الاختيارية والمؤشرات. الصفحة الفارغة ليست دليلا على أن الحساب لم ينشر قط.

أخطاء التحقق

صحح المعلمات غير الصالحة قبل إعادة المحاولة

يؤدي غياب username أو خروج max_results عن النطاق إلى HTTP 400 مع success: false وerror.code: 10001 وerror.message وrequestId. افحص الرسالة وصحح الطلب بدلا من إعادته دون تعديل.

تتبّع الطلبات

احتفظ بمعرّف الطلب لا ببيانات الاعتماد

احتفظ بترويسة الاستجابة X-Request-Id للدعم وتتبع الطلبات. تحقق من حالة HTTP قبل قراءة حمولة نجاح، ولا تضع مفاتيح API أو بيانات الملف الشخصي غير الضرورية في سجلات التطبيق.