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

SEO API עבור הסטאק שלכם

נתוני ה-SEO והנראות ב-AI שלכם, דרך נקודת קצה REST נקייה.

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

קבלו מפתח APIגלו את ה-MCP

אימות Bearer · 60 בקשות/דקה · אותה שכבת נתונים כמו ה-MCP · ללא scraping

seocrawl — REST /v1

$ 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
קבלו מפתח APIRead the API docs
cURLJavaScriptPython
# 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 — כך שלוח הבקרה שלכם וסוכני ה-AI שלכם תמיד רואים מספרים זהים. הקבוצות האלה חיות ב-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 ואינדוקס

תעבורה, מפני AI וסטטוס אינדוקס. התפר מוכן; נקודות הקצה של REST בדרך.

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

ביקורת אתר

בריאות סריקה, on-page, טכני ורשימות בעיות — מערך נתוני הביקורת המלא, חשוף דרך REST.

  • GET/v1/properties/{id}/audit/summaryבקרוב
  • GET/v1/properties/{id}/audit/issuesבקרוב
למה ה-API הזה

נבנה למוצרים, לא ל-scrapers

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

REST נקי, JSON עם טיפוסים

משאבים צפויים, פעלים סטנדרטיים, תגובות JSON עם טיפוסים ושגיאות תואמות RFC (401 לא מאומת, 403 scope_required, 429 עם Retry-After). ללא scraping של HTML, ללא ייצוא שביר.

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

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

מפתחות בשירות עצמי

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

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

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

גישה מוגבלת בהרשאות

הרשאות קריאה וכתיבה גסות שומרות על כל נקודת קצה, נאכפות בחומת האש עם תגובות step-up סטנדרטיות. העניקו לכל מפתח רק את מה שהוא צריך.

רב-דיירים, בקרוב

זרימת Google OAuth לכל דייר כדי ששותפים יוכלו לחבר את נכסי ה-GSC של כל אחד מלקוחותיהם תחת חשבון אחד — עם בידוד נתונים קפדני. בפיתוח פעיל; בקשו מאיתנו גישה מוקדמת.

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

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

1

הנפקת מפתח

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

2

שליחת הכותרת

העבירו `Authorization: Bearer sca_live_…` בכל בקשה אל `https://api.seocrawl.ai/v1`. אותו מפתח עובד גם עם שרת ה-MCP.

3

משיכת נתונים

קִראו ל-`GET /v1/properties` כדי לקבל `id` של נכס, ואז פנו אל `/v1/properties/{id}/…` לביצועי GSC, פרומפטים של AI Tracker או משימות — והזרימו את ה-JSON ישר אל המוצר, לוח הבקרה או המחסן שלכם.

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

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

REST API

למוצרים, לוחות בקרה וצינורות נתונים. אימות Bearer, JSON עם טיפוסים, מגבלות קצב. אתם בעמוד הזה.

שרת MCP

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

גלו את ה-MCP

טרמינל ו-CLI

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

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

מי בונה על ה-API

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

SaaS ושותפים

הטמיעו מדדי SEO חיים בממשק המוצר שלכם. תנו למשתמשים שלכם נתוני Search Console ונראות ב-AI בלי לבנות את הצינורות בעצמכם.

סוכנויות

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

צוותי נתונים

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

מפתחים

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

שאלות נפוצות

האם באמת קיים SEO API ציבורי?

כן — REST `/v1` API עם אימות 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 הראשונה שלכם תוך דקות — או דברו איתנו על גישת שותפים ורב-דיירים.

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