SEO Optimizer
مرجع API
محسّن السيو
يحلل السيو داخل الصفحة، وجاهزية GEO/البحث بالذكاء الاصطناعي، وإشارات ثقة E-E-A-T لصفحة ما، مع عرض جافاسكريبت اختياري، ومقارنة الكلمات المفتاحية/المنافسين، وبيانات Google Search Console.
/api/seo-optimizerasyncيبدأ فحصًا - سيو داخل الصفحة، GEO، E-E-A-T، وعرض JS اختياري
GET /api/seo-optimizer?id={scanId} حتى تصبح قيمة status إما done أو failed.محتوى الطلب
{
"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"}'/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/SPA.