واجهة برمجة التطبيقات REST

بياناتك تنتمي إلى أي لوحة تحكم يستخدمها فريقك بالفعل. 7 نقاط وصول للقراءة، بيانات JSON بسيطة، بدون حاجة لـ SDK.

الرئيسية /
المنصة /
واجهة REST

ثلاثون ثانية حتى أول استجابة

أنشئ مفتاحاً في لوحة التحكم تحت API Keys، ثم أرسله كـ bearer token. هذا كل الإعداد.

# عرض جميع الكلمات المفتاحية التي تتبعها
curl -H "Authorization: Bearer sk_your_key_here" \
     "https://seo.newinterval.com/api/v1/keywords?project_id=3"

{
  "data": [
    {
      "id": 812,
      "keyword": "seo platform lebanon",
      "project_id": 3,
      "country": "LB",
      "location": "Beirut",
      "current_position": 4,
      "last_checked": "2026-07-30 06:12:03"
    }
  ],
  "meta": { "count": 1, "project_id": 3 }
}

كل استجابة تستخدم نفس الهيكل: النتائج تحت data، والسياق تحت meta. الأخطاء تأتي بصيغة {error, code, message} مع رمز HTTP مطابق. لا يوجد شيء آخر لتتعلمه.

نقاط الوصول

جميعها GET. جميعها محدودة بما يحق لمستخدم المفتاح رؤيته — مفتاح صادر لشخص لديه صلاحية على مشروع واحد لا يمكنه قراءة مشروع آخر.

نقطة الوصول	تُرجع	الفلاتر
`/api/v1/`	فهرس نقاط الوصول — مفيد كاختبار اتصال.	—
`/api/v1/projects`	المشاريع التي يمكن لمستخدم المفتاح الوصول إليها.	—
`/api/v1/keywords`	الكلمات المفتاحية المُتتبَّعة مع ترتيباتها الحالية.	project_id, status, search
`/api/v1/positions`	سجل الترتيب الكامل لكلمة مفتاحية.	keyword_id, from, to
`/api/v1/gsc`	نقرات وظهور ومواقع Search Console.	project_id, period_days
`/api/v1/alerts`	التنبيهات الأخيرة.	unread
`/api/v1/credits`	الرصيد الحالي مع آخر عشر حركات في السجل.	—

للقراءة فقط، عن قصد. الواجهة تقرأ بياناتك؛ لا تنشئ مشاريع أو تضيف كلمات مفتاحية أو تشغّل فحوصات. أي شيء يستهلك أرصدة يحدث في لوحة التحكم حيث يمكنك رؤية تكلفته. نقاط الوصول للكتابة مُخطط لها، لكنها ليست في المنتج بعد — لذا لا تبنِ عليها الآن.

المفاتيح والحدود والسلوك الصحيح

يُعرض مرة واحدة، ثم يُشفّر

المفتاح الكامل يظهر مرة واحدة فقط عند إنشائه. بعد ذلك تُعرض أحرفه الأولى فقط. نحن نخزّن تجزئة مشفّرة، وليس المفتاح نفسه — فتسريب قاعدة البيانات لن يمنح أحداً صلاحية الوصول لواجهتك.

1,000 طلب في الساعة

لكل مفتاح، يُحتسب من جهة الخادم. كل استجابة تحمل X-RateLimit-Limit وX-RateLimit-Remaining حتى تتمكن من التباطؤ قبل الوصول للحد وليس بعده.

انتهاء الصلاحية والإلغاء

حدد تاريخ انتهاء للمفتاح عند إنشائه، أو ألغِه فوراً. أصدر مفتاحاً واحداً لكل ربط وستتمكن من قطع شيء واحد بالضبط عند الحاجة.

قراءة API مجانية

قراءة البيانات التي جمعتها سابقاً لا تستهلك أرصدة. اطلب البيانات بقدر ما يسمح حد الطلبات.

المصادقة

أرسل المفتاح كـ bearer token:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

إذا لم يتمكن برنامجك من تعيين الترويسات، يمكنك استخدام معامل ?token= في الرابط كبديل — لكن يُفضل استخدام الترويسة، لأن معاملات الرابط تظهر في سجلات الخادم وسجل المتصفح.

التوفر

الوصول للواجهة البرمجية متاح في باقتَي Agency وNetwork. شاهد المقارنة.

ابنِ عليها

ابدأ بباقة Agency، أنشئ مفتاحاً واحصل على ترتيباتك في لوحة تحكمك الخاصة في نفس اليوم.

ابدأ Agency شاهد جميع الباقات

تسجيل دخول العملاء

تواصل معنا