Search Console API · REST v1 · תיעוד חי

Google Search Console API עבור הסטאק שלכם

נתוני הביצועים של Search Console שלכם, דרך נקודת קצה REST נקייה.

משכו קליקים, חשיפות, CTR ומיקום ממוצע — לפי שאילתה, עמוד וטווח תאריכים — ישירות מ-Google Search Console אל המוצר, לוח הבקרה או מחסן הנתונים שלכם. חברו את GSC פעם אחת בתוך SEOcrawl AI, הנפיקו מפתח Bearer מלוח הבקרה וקִראו ל-REST /v1 — בלי לבנות OAuth של Google בעצמכם. זו אותה שכבת נתונים קנונית שמפעילה את ה-MCP של SEOcrawl AI, כך שהמספרים שלכם תמיד מסתדרים. כיסוי אינדוקס ובדיקת URL מגיעים ל-REST בהמשך; דרך ה-MCP הם כבר חיים היום.

קבלו מפתח APIעיון בתיעוד ה-APIגלו את ה-MCP
Claude
Codex CLI
Cursor
Google Search Console API של SEOcrawl AI — בקשת curl ותגובת JSON עם טיפוסים הכוללת קליקים, חשיפות, CTR ומיקום.
דוגמאות לבקשות אל Google Search Console API ב-cURL, JavaScript ו-Python.

מאתרים נכס. מושכים נתוני GSC.

הנפיקו אסימון Bearer מלוח הבקרה והעבירו אותו בכותרת Authorization. אתרו פעם אחת את מזהה הנכס ב-Search Console, ואז שלפו את הביצועים שלו דרך REST. אותו מפתח עובד גם ב-REST API וגם בשרת ה-MCP.

כתובת URL בסיסית

https://api.seocrawl.ai/v1

כותרת Authorization

Authorization: Bearer sca_live_your_token_here
קבלו מפתח APIRead the API docs

כל מדד של Search Console, דרך REST

קליקים, חשיפות, CTR ומיקום ממוצע — לפי שאילתה, עמוד, טווח תאריכים והשוואת תקופות. כל נקודת קצה מקושרת לנכס: קודם אתרו את ה-id של הנכס, ואז קִראו את נתוני ה-Search Console שלו. קבוצות ה-GSC האלה חיות ב-v1; כיסוי אינדוקס ובדיקת URL נחשפים היום דרך ה-MCP, ונקודות הקצה של REST נוחתות אחריהם.

נכסים

הציגו את נכסי Search Console המחוברים לחשבון שלכם. השתמשו ב-id של כל נכס בנתיב של כל נקודת קצה של GSC.

  • GET/v1/propertiesחי

ביצועים

סך הקליקים, החשיפות, ה-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/keywords/detailחי

עמודים

כתובות ה-URL המובילות שלכם עם מדדי Search Console — והפירוק היומי המלא של ביצועי כל עמוד בודד.

  • GET/v1/properties/{id}/gsc/top-pagesחי
  • GET/v1/properties/{id}/gsc/pages/detailחי

כיסוי אינדוקס

מה ש-Google באמת מאנדקס: מצבי כיסוי והיסטוריית אינדוקס. חי היום ב-MCP; נקודות הקצה של REST בהטמעה.

  • GET/v1/properties/{id}/indexation/summaryבקרוב

בדיקת URL

בדיקה לכל כתובת URL — כיסוי, סריקה אחרונה ומצב אינדוקס של עמוד בודד. זמינה כבר עכשיו דרך ה-MCP; REST בהמשך.

  • GET/v1/properties/{id}/url-inspectionבקרוב

נתוני Search Console אמיתיים, שנבנו למוצרים

הביצועים האמיתיים שלכם ב-Google Search Console — לא הערכות של צד שלישי — דרך REST API נקי עם אימות Bearer ומגבלות קצב, שחולק שכבת נתונים קנונית אחת עם ה-MCP כך שהמספרים לעולם לא סותרים.

ישר מ-Search Console

קליקים, חשיפות, CTR ומיקום ממוצע הנמשכים מנכס ה-GSC שלכם עצמכם — המספרים האמיתיים ש-Google מדווחת, ולא הערכות מודלות או תוצרי scraping. משאבים צפויים, פעלים סטנדרטיים, JSON עם טיפוסים ושגיאות תואמות RFC.

בלי לבנות OAuth של Google

חברו את Search Console פעם אחת בתוך SEOcrawl AI, ואז קִראו אותו עם מפתח Bearer יחיד מסוג sca_live_. דלגו על פרויקט Google Cloud, מסך ההסכמה ורענון האסימונים — הנפיקו ובטלו מפתחות מלוח הבקרה תוך שניות.

שכבת נתונים קנונית אחת

נקודות הקצה של GSC ב-REST וכלי ה-GSC של ה-MCP הם אחים מעל אותו ספק, עם בדיקת שקילות ב-CI. לוח הבקרה שלכם וסוכני ה-AI שלכם תמיד רואים קליקים, חשיפות ומיקומים זהים.

רזולוציה של שאילתה ועמוד

קִראו סיכומים לנכס שלם, או צללו לשאילתות המובילות, לעמודים המובילים, למגמה היומית של מילת מפתח אחת או להיסטוריה של כתובת URL אחת — אותם חתכים שאתם רואים ב-Search Console, נגישים דרך HTTP.

השוואת תקופות מובנית

בקשו range (last_7_days, last_28_days, last_3_months, last_year) או תאריכי from/to מפורשים, וקבלו השוואות תקופות מהקופסה — בלי קריאה שנייה ובלי חשבון תאריכים בצד הלקוח כדי ליישב דלתאות.

מגבלות קצב מתועדות

60 בקשות לדקה ו-1,000 לשעה לכל אסימון, עם תגובות 429 + Retry-After ברורות. מגבלות REST הן מאגר נפרד משימוש ה-MCP — אחד לעולם לא מרעיב את השני.

מתחילים ב-3 שלבים

מאפס ועד קריאת ה-Search Console הראשונה שלכם תוך דקות ספורות.

1

הנפקת מפתח

חברו את Search Console ב-SEOcrawl AI, פתחו אסימוני API וצרו אסימון Bearer. העתיקו אותו פעם אחת — הוא מתחיל ב-sca_live_.

2

איתור נכס

קִראו ל-GET /v1/properties עם Authorization: Bearer sca_live_… כדי לקבל את ה-id (מזהה UUID) של נכס ה-Search Console שאתם רוצים לקרוא.

3

משיכת נתוני GSC

פנו אל /v1/properties/{id}/gsc/summary?range=last_28_days לסיכומים, או אל /gsc/top-keywords, /gsc/top-pages ונקודות הקצה /detail — והזרימו את ה-JSON ישר אל המוצר, לוח הבקרה או המחסן שלכם.

שלוש דרכים להגיע לנתוני ה-Search Console שלכם

אותם מספרי GSC, משטח שונה — בחרו את מה שמתאים לאופן שבו אתם בונים.

REST API

למוצרים, לוחות בקרה וצינורות נתונים. אימות Bearer, JSON עם טיפוסים, מגבלות קצב. אתם בעמוד הזה — ה-SEO API המלא מוסיף נקודות קצה של דירוג ונראות ב-AI עם אותו מפתח.

שרת MCP

לסוכני AI — Claude, ChatGPT וכל לקוח MCP שואלים את נתוני ה-Search Console שלכם בשפה טבעית.

גלו את ה-MCP

טרמינל ו-CLI

לסקריפטים ו-CI/CD — הפעילו את נתוני ה-GSC שלכם מכל סוכן טרמינל תומך-MCP.

ראו את ה-CLI
השוו את כל האינטגרציות

מי בונה על ה-Search Console API

צוותים שרוצים נתוני ביצועים אמיתיים מ-GSC בתוך המערכות שלהם.

סוכנויות

הזרימו את נתוני ה-Search Console של כל לקוח אל פורטל מותאם, Looker Studio או שכבת הדיווח שלכם — מפתח אחד, כל הנכסים, בלי ייצוא ידני מ-GSC.

SaaS ושותפים

הטמיעו מדדי Search Console חיים בממשק המוצר שלכם. תנו למשתמשים שלכם קליקים, חשיפות ומיקומים בלי לחבר בעצמכם את ה-API של Google.

צוותי נתונים

הנחיתו קליקים, חשיפות, CTR ומיקום מ-GSC במחסן שלכם לפי לוח זמנים. חברו אותם להכנסות ובנו את המודלים שלוחות הבקרה שלכם צריכים.

מפתחים

הפכו ניטור שאילתות ועמודים לאוטומטי, קבלו התראות על צניחות בדירוג, וחברו נתוני Search Console אל האפליקציות והתהליכים שאתם כבר משיקים.

שאלות נפוצות

האם זה ה-API הרשמי של Google Search Console?

לא. זהו REST API עם אימות Bearer של SEOcrawl AI עצמה, מעל נתוני ה-Search Console שכבר חיברתם לחשבון שלכם. אתם מחברים את GSC פעם אחת בתוך SEOcrawl AI, ומשם קוראים קליקים, חשיפות, CTR ומיקום דרך מפתח sca_live_ אחד ונקי — בלי לבנות בעצמכם פרויקט Google Cloud, מסך הסכמה של OAuth או רענון אסימונים. המספרים הם מספרי ה-Search Console האמיתיים שלכם; ה-API והאימות הם שלנו.

אילו נתוני Search Console אפשר למשוך היום?

סיכומים לטווח תאריכים (קליקים, חשיפות, CTR, מיקום ממוצע), השוואות בין תקופות, השאילתות והעמודים המובילים שלכם עם מדדים, והפירוט היומי המלא של מילת מפתח בודדת או עמוד בודד — בתוספת רשימת הנכסים המחוברים שלכם. כיסוי אינדוקס ובדיקת URL חיה זמינים כבר עכשיו דרך ה-MCP; נקודות הקצה שלהם ב-REST נוחתות בהמשך. ואם אתם מעדיפים לקרוא את החשבון במקום לשלוף ממנו, ביקורת Google Search Console מכסה את אותם נתונים בפרומפט אחד.

איך מבצעים אימות?

עם אסימון Bearer. הנפיקו מפתח sca_live_ מלוח הבקרה שלכם ושלחו אותו כ-Authorization: Bearer <key> בכל בקשה. אין ריקוד OAuth לחשבון שלכם — רק הכותרת.

אילו טווחי תאריכים נתמכים?

כל נקודת קצה של GSC מקבלת או range (last_7_days, last_28_days, last_3_months או last_year) או זוג from/to מפורש. נקודת הקצה gsc/compare מחזירה את אותו חלון בהשוואה לתקופה שקדמה לו, כך שאתם מקבלים דלתאות בלי קריאה שנייה.

מהן מגבלות הקצב?

60 בקשות לדקה ו-1,000 לשעה לכל אסימון. חִרגו מהן ותקבלו 429 עם כותרת Retry-After. מגבלות REST נמדדות בנפרד משימוש ה-MCP, כך שהשניים לעולם לא מתחרים על אותו תקציב.

האם זה אותו מפתח ואותם נתונים כמו ה-MCP?

כן. אותו אסימון sca_live_ מאמת גם את ה-REST API וגם את שרת ה-MCP, ושניהם קוראים משכבת נתונים קנונית אחת — כך שמספרי ה-Search Console שאתם מושכים דרך REST זהים למה שסוכני ה-AI שלכם רואים דרך ה-MCP. אישור אחד, שני משטחים.

מוכנים לבנות על נתוני ה-Search Console שלכם?

חברו את GSC פעם אחת, הנפיקו מפתח Bearer מלוח הבקרה ובצעו את קריאת ה-REST הראשונה שלכם ל-Search Console תוך דקות — או גלו את ה-MCP לסוכני AI.

קבלו מפתח APIעיון בתיעוד ה-APIהזמינו הדגמה