Skip to content
SEO Optimizer is live, Audit on page SEO and AI-search readiness. Try it free
Scanverra
SEO Optimizer

مرجع API

محسّن السيو

يحلل السيو داخل الصفحة، وجاهزية GEO/البحث بالذكاء الاصطناعي، وإشارات ثقة E-E-A-T لصفحة ما، مع عرض جافاسكريبت اختياري، ومقارنة الكلمات المفتاحية/المنافسين، وبيانات Google Search Console.

POST/api/seo-optimizerasync

يبدأ فحصًا - سيو داخل الصفحة، GEO، E-E-A-T، وعرض JS اختياري

docsApiSeoOptimizer.scanCallout

محتوى الطلب

{
  "url": "https://example.com/page",
  "keyword": "target keyword",
  "competitorUrl": "https://competitor.com/page",
  "renderJs": false
}

الاستجابة (فورية)

{
  "scanId": "clxyz..."
}

مثال

curl -X POST https://www.scanverra.com/api/seo-optimizer \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page","keyword":"widgets"}'
GET/api/seo-optimizersynchronous

يجلب حالة الفحص ونتائجه الكاملة بمجرد اكتماله

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

?id={scanId}

الاستجابة

{
  "id": "clxyz...",
  "status": "done",
  "score": 88,
  "pageData": {...},
  "findings": [...],
  "keywordAnalyses": [...],
  "crawlability": {...},
  "aiSuggestions": {...},
  "competitorPageData": {...},
  "competitorFindings": [...]
}

قيمة status هي running أو done أو failed. لا تُملأ pageData وfindings وaiSuggestions إلا عندما تكون status هي done.

مثال

curl "https://www.scanverra.com/api/seo-optimizer?id=clxyz..." \
  -H "X-API-Key: sk_live_..."

حقول الطلب الاختيارية

keyword: كلمات مفتاحية مستهدفة مفصولة بفواصل للتحقق من موضعها/كثافتها. competitorUrl: رابط ثانٍ يُفحص ويُقارن في نفس التقرير. renderJs: اضبطه على true لعرض الصفحة أولًا في متصفح بدون واجهة - أبطأ، لكنه يعرض محتوى قد يفوته الجلب البسيط في مواقع React/Vue/تطبيقات الصفحة الواحدة.