كيف تتحقق من ترتيب الكلمات المفتاحية باستخدام Google API (دليل 2026)

تبدو محاولة التحقق من ترتيب الكلمات المفتاحية باستخدام Google API من تلك المهام المحلولة مسبقًا إلى أن تجربها بنفسك. فلا توجد نقطة نهاية rankings.get()، وكل واحدة من واجهتي Google اللتين يلجأ إليهما الناس أولًا تجيب عن سؤال يختلف قليلًا عن السؤال المطروح. وتُعد وثائق Search Analytics في Search Console نقطة البداية الصحيحة، بشرط أن تفهم ما تعنيه كلمة «الموضع» (position) فيها.

هل لدى Google واجهة API رسمية لترتيب الكلمات المفتاحية؟

لا. لم تطلق Google قط واجهة API تستقبل كلمة مفتاحية وتعيد ترتيبك اللحظي على google.com. وهذا مقصود: فالاستعلام الآلي من صفحة نتائج البحث محظور بموجب شروط Google، وليس للشركة أي مصلحة تجارية في توفير بنية تحتية لتتبع الترتيب.

المتاح بدلًا من ذلك ثلاث طرق جزئية، لكل منها حدّ صارم:

كيف أحصل على ترتيب الكلمات المفتاحية من Search Console API؟

استعلم من نقطة النهاية searchAnalytics باستخدام البُعد query واقرأ الحقل position. هذه بيانات من المصدر الأول مباشرة من Google، وهي مجانية ولا حدّ فيها لعدد الكلمات المفتاحية: تحصل على كل استعلام حقق فيه موقعك مرات ظهور.

الطلب العملي بلغة Python:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

القيود الثلاثة التي تفاجئ الكثيرين

• الموضع قيمة متوسطة. القيمة 7.4 لا تعني أنك تحتل الموضع 7، فهي تعني أن مرات الظهور توزعت على مواضع متوسطها 7.4، وربما تراوحت بين 3 و15 حسب الأجهزة والمواقع الجغرافية.
• موقعك فقط. لا توجد طريقة لرؤية موضع أحد المنافسين. فـ Search Console واجهة API مقيّدة بالموقع (property) بحكم تصميمها.
• الكلمات المفتاحية التي لا تحقق أي ظهور غير مرئية. إذا كنت في الموضع 60 ولم يمرر أحد إلى هذا الحد، فلن يظهر الاستعلام في البيانات على الإطلاق.

وهذه النقطة الثالثة هي التي تُفسد التقارير بصمت. فالكلمة المفتاحية التي لم تصل بعد إلى الصفحات الأولى غير موجودة في Search Console أصلًا، ما يجعل قياس التقدم من الموضع 60 إلى الموضع 20 مستحيلًا باستخدام هذه الواجهة وحدها.

هل يمكنني استخدام Custom Search JSON API للتحقق من الترتيب؟

تقنيًا نعم، أما من حيث الجدوى فلا. تتطلب Custom Search JSON API أن تنشئ أولًا محرك بحث قابلًا للبرمجة (Programmable Search Engine). وحتى عند إعداده للبحث في الويب بأكمله، فإنه يطبق ترتيبه وقيوده الخاصة، لذا فالترتيب الذي يعيده يختلف عن ترتيب google.com.

كما أنها محدودة بـ 100 استعلام يوميًا في الفئة المجانية، مع احتساب الاستخدام المدفوع لكل ألف استعلام وسقف يومي. وهي صالحة لعدد قليل من الكلمات المفتاحية تتحقق منها من حين لآخر. أما كأداة لتتبع الترتيب فتنتج أرقامًا تبدو موثوقة لكنها خاطئة بصمت، وهذا أسوأ من عدم امتلاك أي بيانات.

وماذا عن استخراج البيانات من Google مباشرة؟

لا تفعل ذلك. الاستعلام الآلي من Google Search دون إذن يخالف شروط خدمة Google، وعند أي حجم يعرّضك لحظر عنوان IP ولجدران CAPTCHA. وبعيدًا عن مسألة السياسات، فالواقع الهندسي مزعج: النتائج مخصصة ومحلية وتُجمَّع على نحو متزايد بميزات الذكاء الاصطناعي، لذا فإن «الموضع» المستخرج يختلف حسب مركز البيانات والموقع الجغرافي والجلسة حتى عندما لا يتغير شيء في موقعك.

إذا كنت تحتاج إلى مواضع المنافسين، فواجهة SERP API التجارية هي الطريق القانوني بموجب اتفاقيات المزوّد نفسه والمستقر تشغيليًا. إنها بند مدفوع، وهذه التكلفة هي الثمن الحقيقي لبيانات لا تمنحها Google مجانًا. وعادةً ما تستعين الشركات التي تحتاج إلى بناء هذا المسار ومراقبته دون توظيف داخلي بجهة متخصصة، وتعرض مقارنتنا لـ أفضل 10 وكالات لتحليل البيانات في فرنسا مزوّدين يعدّون هذا النوع من التقارير.

ما الذي ينبغي أن تبنيه؟

بالنسبة إلى معظم الفرق، البنية العملية هي بنية هجينة، وتبدو كالتالي:

• Search Console API كعمود فقري. مجانية، وبلا حدود لعدد الكلمات المفتاحية، ومن المصدر الأول، وهي المصدر الوحيد الذي يخبرك بما تحقق فيه مرات ظهور حقيقية.
• SERP API لمجموعة صغيرة منتقاة من الكلمات المفتاحية. عشرون أو ثلاثون مصطلحًا من مصطلحاتك الحاسمة تجاريًا، يُتحقق منها يوميًا، بما في ذلك مواضع المنافسين.
• طبقة للظهور في الذكاء الاصطناعي. بات السؤال يتجاوز «ما موضعي؟» إلى «هل يُستشهد بي عندما يسأل أحدهم مساعد ذكاء اصطناعي؟». وواجهات الترتيب التقليدية لا تجيب عن أي شيء من ذلك.

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

وهذه النقطة الأخيرة تخص الحاضر. فعندما تحسم إجابة الذكاء الاصطناعي الاستعلام داخل الواجهة، يؤدي الموضع العاشر والموضع الثالث إلى النتيجة نفسها: لا نقرة. وتتبع الاستشهادات إلى جانب الترتيب هو ما صُمم من أجله خادم MCP لـ Search Console ومنصة الظهور في الذكاء الاصطناعي لدينا، وتشرح الوثائق الإعداد من البداية إلى النهاية.

الخلاصة

لا توجد واجهة API رسمية من Google للترتيب اللحظي للكلمات المفتاحية: استخدم Search Console API لبياناتك الخاصة المحسوبة كمتوسطات، وواجهة SERP API من طرف ثالث للمواضع الدقيقة ومواضع المنافسين، وتجنّب Custom Search JSON API تمامًا في أعمال الترتيب. والبناء على الواجهة الخاطئة هو الخطأ الأكثر شيوعًا هنا، وينتج عنه لوحة معلومات غير دقيقة رغم ما تبديه من ثقة.

إذا كنت تفضّل عدم بناء هذا المسار وصيانته بنفسك، فإن Sorank تربط Search Console الخاص بك وتتتبع الاستشهادات في الذكاء الاصطناعي في مكان واحد.