تخطي إلى المحتوى الرئيسي
للمطورين

SERPHub REST API

أكثر من 35 endpoint. استجابات JSON. مصادقة رموز Sanctum. اسحب بيانات SEO إلى أي أداة أو لوحة أو سير عمل.

احصل على API Token تحدث إلى المبيعات

البدء السريع

أنشئ رمز Sanctum API من إعدادات حسابك، ثم أرسله كرمز Bearer في كل طلب.

  1. 1 سجّل الدخول → إعدادات الحساب → الأمان → API Tokens → أنشئ رمزًا
  2. 2 أضف الرمز في كل طلب بالشكل Authorization: Bearer YOUR_TOKEN
  3. 3 عنوان الأساس: https://dev.serphub.io/api/v1
curl 
curl https://dev.serphub.io/api/v1/sites \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
الاستجابة (200) 
{
  "data": [
    {
      "id": 42,
      "domain": "example.com",
      "health_score": 91,
      "last_audit_at": "2026-05-20T08:15:00Z"
    }
  ]
}

مرجع API

كل endpoint يعيد JSON. كل عمليات الكتابة تتطلب جسم POST بصيغة JSON مع Content-Type: application/json.

المواقع

GET /sites
GET /sites/{id}
POST /sites

التدقيقات

GET /sites/{id}/audit
POST /sites/{id}/audit
GET /sites/{id}/audit/progress
GET /sites/{id}/issues

الكلمات المفتاحية

GET /sites/{id}/keywords
GET /sites/{id}/pages
GET /sites/{id}/cannibalization
GET /sites/{id}/search-intent

الروابط الخلفية

GET /sites/{id}/backlinks
GET /sites/{id}/internal-links
GET /sites/{id}/content-decay

إشارات AI

GET /sites/{id}/aeo
POST /sites/{id}/ai/chat

المنافسون

GET /sites/{id}/competitors
GET /sites/{id}/visibility
GET /sites/{id}/search-overview

المصادقة وحدود المعدل

Bearer Token (Sanctum)

يجب أن يتضمن كل طلب API رمز وصول شخصي صالح من Sanctum. أنشئ الرموز من الحساب → الأمان → API Tokens. لا تنتهي صلاحية الرموز، لكن يمكن إلغاؤها في أي وقت.

حدود المعدل

الوصول إلى API متاح في الخطط التي تتضمن حصة API — Pro وAgency وEnterprise.

الخطة طلبات/دقيقة طلبات/شهر
Pro601,000
Agency6010,000
Enterpriseمخصصمخصص

استجابات الأخطاء

تستخدم API رموز حالة HTTP القياسية. تتضمن استجابات الخطأ جسم JSON يحتوي على حقل message. 401 = رمز غير صالح، 403 = ممنوع، 422 = خطأ تحقق، 429 = تجاوز حد المعدل.

مثال خطأ

HTTP/1.1 422
{
  "message": "Validation error",
  "errors": {
    "domain": [
      "The domain field is required."
    ]
  }
}

جاهز للتكامل؟

يتوفر وصول API في خطة Pro وما فوق. سجّل للبدء.

ابدأ مجانًا استفسار مؤسسي