ל-Google אין API לדירוגים בזמן אמת. מה ה-Search Console API מחזיר בפועל, למה Custom Search מטעה, וקוד Python עובד לכל אחת מהדרכים.

הניסיון לבדוק מיקום של מילת מפתח באמצעות Google API הוא אחת המשימות שנראות פתורות עד שמנסים לבצע אותן. אין endpoint בשם rankings.get(), ושני ה-API של Google שאליהם פונים קודם עונים כל אחד על שאלה שונה במעט מזו שנשאלה. התיעוד של Search Analytics ב-Search Console הוא המקום הנכון להתחיל בו, בתנאי שמבינים מה פירוש "מיקום" שם.
לא. Google מעולם לא שחררה API שמקבל מילת מפתח ומחזיר את המיקום שלכם ב-google.com בזמן אמת. זה מכוון: שליחת שאילתות אוטומטיות לדף התוצאות אסורה לפי התנאים של Google, ולחברה אין אינטרס מסחרי לספק תשתית למעקב דירוגים.
מה שקיים במקום זה הן שלוש דרכים חלקיות, ולכל אחת גבול ברור:
| דרך | מה מחזירה | מכסה מתחרים? | עלות |
|---|---|---|---|
| Search Console API | מיקום ממוצע, לאתר שלכם בלבד | לא | חינם |
| Custom Search JSON API | תוצאות ממנוע מותאם אישית | כן, אבל לא SERP אמיתי | 100 שאילתות ביום בחינם |
| SERP API של צד שלישי | מיקומים מדויקים ב-SERP בזמן אמת | כן | בתשלום, לפי שאילתה |
שלחו שאילתה ל-endpoint של 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}")
הנקודה השלישית היא זו שהורסת דוחות בשקט. מילת מפתח שעוד לא הצלחתם לפרוץ איתה לעמודים הראשונים לא קיימת ב-Search Console, ולכן אי אפשר למדוד התקדמות ממיקום 60 למיקום 20 באמצעות ה-API הזה לבדו.
מבחינה טכנית כן, אבל בלי ערך של ממש. ה-Custom Search JSON API מחייב ליצור קודם Programmable Search Engine. גם כשמגדירים אותו לחפש בכל הרשת, הוא מפעיל דירוג והגבלות משלו, כך שהסדר שהוא מחזיר אינו הסדר ש-google.com מחזיר.
הוא גם מוגבל ל-100 שאילתות ביום ברמה החינמית, כשהשימוש בתשלום מחויב לפי אלף שאילתות ועם תקרה יומית. לבדיקה מזדמנת של כמה מילות מפתח זה עובד. ככלי למעקב דירוגים הוא מייצר מספרים שנראים סמכותיים ושגויים בשקט, וזה גרוע יותר מאשר לא לקבל נתונים בכלל.
אל תעשו את זה. שליחת שאילתות אוטומטיות ל-Google Search ללא רשות מנוגדת לתנאי השימוש של Google, ובכל נפח משמעותי היא מזמינה חסימות IP וחומות CAPTCHA. מעבר לשאלת המדיניות, המציאות ההנדסית לא נעימה: התוצאות מותאמות אישית, מותאמות למיקום ונבנות יותר ויותר עם רכיבי AI, כך ש"מיקום" שנאסף בגרידה משתנה לפי מרכז נתונים, מיקום וסשן, גם כששום דבר באתר שלכם לא השתנה.
אם אתם צריכים מיקומים של מתחרים, SERP API מסחרי הוא הדרך שגם חוקית במסגרת ההסכמים של הספק וגם יציבה מבחינה תפעולית. זו שורת הוצאה בתשלום, והעלות הזו היא המחיר ההוגן של נתונים ש-Google לא מחלקת בחינם. עסקים שצריכים שמישהו יבנה ויתחזק את התהליך הזה בלי לגייס צוות פנימי מביאים בדרך כלל מומחה; ההשוואה שלנו של 10 סוכנויות ניתוח הנתונים הטובות בצרפת מציגה ספקים שמקימים דיווח מהסוג הזה.

ברוב הצוותים, הארכיטקטורה הפרגמטית היא היברידית, והיא נראית כך:
צוותים שמעדיפים לא לתכנן את זה בעצמם מעבירים זאת בדרך כלל למומחה; ההשוואה שלנו של 10 סוכנויות ה-SEO הטובות בצרפת מציגה ספקים שמנהלים את מערך הדיווח הזה עבור לקוחות.
הנקודה האחרונה רלוונטית כבר היום. כשתשובת AI פותרת את השאילתה בתוך הממשק, מיקום עשר ומיקום שלוש מובילים לאותה תוצאה: אין קליק. מעקב אחרי ציטוטים לצד מיקומים הוא מה ששרת ה-MCP שלנו ל-Search Console ופלטפורמת הנראות ב-AI שלנו נבנו לעשות, והתיעוד מכסה את ההגדרה מקצה לקצה.
אין API רשמי של Google למיקומי מילות מפתח בזמן אמת: השתמשו ב-Search Console API לנתונים הממוצעים של האתר שלכם, ב-SERP API של צד שלישי למיקומים מדויקים ותחרותיים, ואל תשתמשו כלל ב-Custom Search JSON API לעבודה על דירוגים. בנייה על הכלי הלא נכון היא הטעות הנפוצה ביותר כאן, והיא מייצרת לוח בקרה שגוי בביטחון מלא.
אם אתם מעדיפים לא לבנות ולתחזק את התהליך הזה בעצמכם, Sorank מחברת את Search Console שלכם ועוקבת אחרי ציטוטים ב-AI במקום אחד.
לא. Google מעולם לא פרסמה API שמקבל מילת מפתח ומחזיר את המיקום שלכם ב-google.com בזמן אמת. ה-Search Console API מחזיר מיקום ממוצע לנכס המאומת שלכם בלבד, וה-Custom Search JSON API שולח שאילתות למנוע מותאם אישית שהסדר שלו לא תואם את google.com.
לא. Search Console מדווח על מיקום ממוצע על פני כל החשיפות, משוקלל לפי מכשירים, מיקומים גיאוגרפיים ותאריכים. ערך מדווח של 7.4 לא אומר מיקום 7; ייתכן שהחשיפות נעו בין מיקום 3 למיקום 15 במהלך התקופה.
שליחת שאילתות אוטומטיות ל-Google Search ללא רשות מנוגדת לתנאי השימוש של Google, ובכל נפח משמעותי היא גורמת לחסימות IP ול-CAPTCHA. SERP API מסחרי הוא הדרך שגם מותרת לפי ההסכם של הספק וגם יציבה מבחינה תפעולית.
הם ניסו את Sorank לפניכם
