SEO API لمنظومتك التقنية الخاصة
بيانات SEO وظهورك في الذكاء الاصطناعي، عبر نقطة نهاية REST نظيفة.
اسحب بيانات Google Search Console والترتيب وAI Tracker مباشرةً إلى منتجك أو لوحة تحكمك أو مستودع بياناتك. صادِق باستخدام مفتاح Bearer من لوحة التحكم، واستدعِ REST `/v1`، واحصل على JSON مُنمّط — نفس طبقة البيانات القانونية التي تُشغّل MCP الخاصة بـ SEOcrawl AI. GA4 وتصدير تدقيق الموقع الكامل وOAuth للشركاء متعدد المستأجرين قيد الطرح تاليًا.
مصادقة Bearer · 60 طلبًا/دقيقة · نفس طبقة بيانات MCP · بلا استخلاص
$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
-H "Authorization: Bearer sca_live_…"
{ "data": {
"period": { "from": "2026-06-09", "to": "2026-07-06" },
"metrics": {
"clicks": 2388, "impressions": 811019,
"ctr": 0.00294, "position": 22.87
},
"metrics_diff": { "clicks": 584, … }
} }
صادِق مرة واحدة. استدعِ REST.
أنشئ رمز Bearer من لوحة التحكم ومرّره في ترويسة Authorization. نفس المفتاح يعمل على واجهة REST API وخادم MCP معًا.
عنوان URL الأساسي
https://api.seocrawl.ai/v1ترويسة Authorization
Authorization: Bearer sca_live_your_token_here# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
-H "Authorization: Bearer sca_live_…"
curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
-H "Authorization: Bearer sca_live_…"
// JavaScript
const res = await fetch(
"https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
{ headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();
# Python
import requests
r = requests.get(
f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
params={"range": "last_28_days"},
headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())طبقة بيانات واحدة، سطحان
كل نقطة نهاية REST تقرأ من نفس الطبقة القانونية التي تعتمدها أدوات MCP — فترى لوحة تحكمك ووكلاء الذكاء الاصطناعي لديك الأرقام نفسها دائمًا. هذه المجموعات حيّة في v1؛ والمزيد من التغطية يصل باستمرار.
النطاقات
اسرد نطاقات Search Console التي يمكنك الوصول إليها. استخدم `id` كل نطاق في مسار كل نقطة نهاية بيانات.
- GET
/v1/propertiesحيّة
Google Search Console
النقرات والظهور وCTR ومتوسط الموضع — حسب الاستعلام والصفحة ونطاق التاريخ والمقارنة بين الفترات.
- GET
/v1/properties/{id}/gsc/summaryحيّة - GET
/v1/properties/{id}/gsc/compareحيّة - GET
/v1/properties/{id}/gsc/top-keywordsحيّة - GET
/v1/properties/{id}/gsc/top-pagesحيّة - GET
/v1/properties/{id}/gsc/keywords/detailحيّة - GET
/v1/properties/{id}/gsc/pages/detailحيّة
AI Tracker
اقرأ المطالبات التي تراقبها لرصد ذكر علامتك عبر ChatGPT وClaude وGemini وPerplexity.
- GET
/v1/properties/{id}/ai-tracker/promptsحيّة
المهام
اقرأ واكتب مهام SEO — اربط لوحة مهامك بمنظومة إدارة المشاريع الخاصة بك.
- GET
/v1/properties/{id}/tasksحيّة - POST
/v1/properties/{id}/tasksحيّة - GET
/v1/properties/{id}/tasks/{ticketId}حيّة - PATCH
/v1/properties/{id}/tasks/{ticketId}حيّة - POST
/v1/properties/{id}/tasks/{ticketId}/commentsحيّة
GA4 والفهرسة
الترافيك وإحالات الذكاء الاصطناعي وحالة الفهرسة. الوصلة جاهزة؛ ونقاط نهاية REST قيد الطرح.
- GET
/v1/properties/{id}/ga4/summaryقريبًا - GET
/v1/properties/{id}/indexation/summaryقريبًا
تدقيق الموقع
صحة الزحف والعناصر داخل الصفحة والجوانب التقنية وقوائم المشكلات — مجموعة بيانات التدقيق الكاملة، معروضة عبر REST.
- GET
/v1/properties/{id}/audit/summaryقريبًا - GET
/v1/properties/{id}/audit/issuesقريبًا
مبنية للمنتجات، لا لأدوات الاستخلاص
واجهة REST API حقيقية بمصادقة Bearer ونطاقات صلاحيات وحدود معدّل — تشارك طبقة بيانات قانونية واحدة مع MCP فلا تختلف الأرقام أبدًا.
REST نظيفة، JSON مُنمّط
موارد متوقّعة، وأفعال قياسية، واستجابات JSON مُنمّطة، وأخطاء متوافقة مع RFC (401 غير مُصادَق، 403 scope_required، 429 مع Retry-After). بلا استخلاص HTML، وبلا عمليات تصدير هشّة.
طبقة بيانات قانونية واحدة
نقاط نهاية REST وأدوات MCP شقيقتان فوق نفس المزوّدين، مع اختبار التطابق في CI. لوحة تحكمك ووكلاء الذكاء الاصطناعي لديك يرون النقرات والظهور والمواضع نفسها دائمًا.
مفاتيح ذاتية الخدمة
أنشئ وألغِ رموز Bearer من لوحة التحكم خلال ثوانٍ. نفس مفتاح sca_live_ يصادق على واجهة REST API وخادم MCP معًا — بيانات اعتماد واحدة، سطحان.
حدود معدّل موثّقة
60 طلبًا في الدقيقة و1,000 في الساعة لكل رمز، مع استجابات 429 + Retry-After واضحة. حدود REST هي مجموعة منفصلة عن استخدام MCP — فلا يستنزف أحدهما الآخر أبدًا.
وصول مُقيّد بالنطاقات
نطاقات قراءة وكتابة عامة تحرس كل نقطة نهاية، مفروضة عند الجدار الناري باستجابات ترقية قياسية. امنح كل مفتاح ما يحتاجه فقط.
متعدد المستأجرين، قريبًا
تدفق Google OAuth لكل مستأجر يتيح للشركاء ربط نطاقات GSC لكل عميل من عملائهم تحت حساب واحد — مع عزل صارم للبيانات. قيد التطوير النشط؛ اطلب منا وصولًا مبكرًا.
ابدأ في 3 خطوات
من الصفر إلى أول استدعاء مُصادَق عليه خلال دقيقتين.
أرسل الترويسة
مرّر `Authorization: Bearer sca_live_…` في كل طلب إلى `https://api.seocrawl.ai/v1`. نفس المفتاح يعمل أيضًا مع خادم MCP.
اسحب البيانات
استدعِ `GET /v1/properties` للحصول على `id` نطاق، ثم استدعِ `/v1/properties/{id}/…` لأداء GSC أو مطالبات AI Tracker أو المهام — ووجّه JSON مباشرةً إلى منتجك أو لوحة تحكمك أو مستودعك.
ثلاث طرق للوصول إلى بياناتك
الأرقام نفسها، بسطح مختلف — اختر ما يناسب طريقة بنائك.
REST API
للمنتجات ولوحات التحكم وخطوط أنابيب البيانات. مصادقة Bearer، وJSON مُنمّط، وحدود معدّل. أنت على هذه الصفحة.
خادم MCP
لوكلاء الذكاء الاصطناعي — Claude وChatGPT وأي عميل MCP يستعلم بياناتك باللغة الطبيعية.
استكشف MCPمن يبني على الواجهة
الفرق التي تريد بيانات SEO وظهور الذكاء الاصطناعي داخل أنظمتها الخاصة.
SaaS والشركاء
ادمج مقاييس SEO الحيّة في واجهة منتجك الخاصة. امنح مستخدميك بيانات Search Console وظهور الذكاء الاصطناعي دون بناء خطوط الأنابيب بنفسك.
الوكالات
وجّه بيانات كل عميل إلى بوابة مخصّصة أو Looker Studio أو طبقة تقاريرك — مفتاح واحد، وكل نطاق، وبلا تصدير يدوي.
فِرق البيانات
أنزِل بيانات GSC والترتيب وAI Tracker في مستودعك وفق جدول زمني. اربطها بالإيرادات وابنِ النماذج التي تحتاجها لوحاتك.
المطوّرون
أتمِت الفحوصات والتنبيهات، وزامِن المهام مع أداة إدارة مشاريعك، واربط مراقبة ظهور الذكاء الاصطناعي بالتطبيقات التي تطلقها بالفعل.
الأسئلة الشائعة
هل توجد فعلًا واجهة SEO API عامة؟
نعم — واجهة REST `/v1` مُصادَق عليها بـ Bearer حيّة، تغطي أداء Search Console والنطاقات ومطالبات AI Tracker والمهام، مع المرجع العام الكامل المنشور على api.seocrawl.ai/docs. قريبًا: تغطية أوسع (GA4 وتصدير تدقيق الموقع الكامل) وOAuth للشركاء متعدد المستأجرين. تحتاج شيئًا ليس حيًّا بعد؟ اطلب منا وصولًا مبكرًا.
كيف أُصادِق؟
برمز Bearer. أنشئ مفتاح `sca_live_` من لوحة التحكم وأرسله كـ `Authorization: Bearer <key>` في كل طلب. لا حاجة إلى رقصة OAuth لحسابك الخاص — الترويسة فقط.
هل هو نفس مفتاح MCP؟
نعم. نفس الرمز يصادق على واجهة REST API وخادم MCP، لأن كليهما يقرأ من طبقة بيانات قانونية واحدة. بيانات اعتماد واحدة، سطحان — وأرقام متطابقة عبرهما.
ما هي حدود المعدّل؟
60 طلبًا في الدقيقة و1,000 في الساعة لكل رمز. تجاوزها فتحصل على `429` مع ترويسة `Retry-After`. تُتتبَّع حدود REST بشكل منفصل عن استخدام MCP، فلا يتنافس الاثنان على الميزانية نفسها أبدًا.
هل يمكنني ربط نطاقات Search Console الخاصة بعملائي؟
ذلك التدفق للشركاء متعدد المستأجرين — Google OAuth لكل مستأجر يتيح لك ربط نطاقات GSC لكل عميل من عملائك تحت حسابك الخاص، مع عزل صارم للبيانات — قيد التطوير النشط. إن كنت تبني تكاملًا للشركاء، تواصل معنا للوصول المبكر.
ما البيانات التي يمكنني سحبها اليوم؟
ملخص Search Console ومقارنات الفترات، وأهم الكلمات المفتاحية والصفحات، وتفاصيل كلمة/صفحة واحدة، وقائمة نطاقاتك، ومطالبات AI Tracker، وقراءة/كتابة كاملة على المهام. إنها تعكس ما تعرضه MCP، عبر REST.
جاهز للبناء على بيانات SEO الخاصة بك؟
أنشئ مفتاح Bearer من لوحة التحكم وأجرِ أول استدعاء REST خلال دقائق — أو تحدّث إلينا حول وصول الشركاء ومتعدد المستأجرين.