שליפת תוצאות Google AI Mode SERP מתקדמות לפי id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
שליפת תוצאות Google AI Mode SERP מתקדמות לפי id
מאחזר תוצאת Google ai mode שנכנסה לתור, לפי id. מחזיר keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ו-items. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: object | null · Response36Afe1097B20_SerpGoogleAiModeTaskGetAdvancedResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_SerpGoogleAiModeTaskGetAdvancedTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- idסוג: string | null
מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID
- pathסוג: array (string | null)[] | null
נתיב URL
- resultסוג: array (object | null)[] | null
מערך תוצאות
- checkסוג: string | null
_url כתובת URL ישירה לתוצאות מנוע החיפוש
אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות - datetimeסוג: string | null
התאריך והשעה שבהם התוצאה התקבלה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - itemסוג: array (string | null)[] | null
_types סוגי תוצאות החיפוש ב-SERP
מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP.
סוגי פריטים אפשריים:ai_overview - itemsסוג: array (object | null)[] | null
פריטים שמופיעים ברכיב
- itemsסוג: array (object | null)[] | null
פריטים שמופיעים ברכיב
- positionסוג: string | null
יישור הרכיב ב-SERP
יכול לקבל את הערכים הבאים:left,right - typeסוג: string | null
סוג הרכיב
- markdownסוג: string | null
- pageסוג: integer | null
עמוד SERP
עמוד ה-SERP שעליו הרכיב מדורג - positionסוג: string | null
יישור הרכיב ב-SERP
יכול לקבל את הערכים הבאים:left,right - rankסוג: integer | null
_absolute דירוג מוחלט ב-SERP
מיקום מוחלט מבין כל הרכיבים ב-SERP - rankסוג: integer | null
_group דירוג קבוצה ב-SERP
מיקום בתוך קבוצה של רכיבים עם ערכיtypeזהים
מיקומים של רכיבים עם ערכיtypeשונים מושמטים מ-rank_group - rectangleסוג: object | null · Response36Afe1097B20_AiModeRectangleInfo
פרמטרי מלבן
מכיל קואורדינטות קרטזיות וממדי פיקסלים של מקטע התוצאה ב-SERP
שווה ל-nullאםcalculate_rectanglesבבקשת POST אינו מוגדר ל-true- heightסוג: number | null פורמט: double
הגובה של הרכיב בפיקסלים
- widthסוג: number | null פורמט: double
הרוחב של הרכיב בפיקסלים
- xסוג: number | null פורמט: double
קואורדינטת ציר x קואורדינטת ציר x של הפינה השמאלית העליונה של מקטע התוצאה, כאשר הפינה השמאלית העליונה של המסך היא נקודת המוצא
- yסוג: number | null פורמט: double
קואורדינטת ציר y קואורדינטת ציר y של הפינה השמאלית העליונה של מקטע התוצאה, כאשר הפינה השמאלית העליונה של המסך היא נקודת המוצא
- referencesסוג: array (object | null)[] | null
הפניות נוספות הרלוונטיות לפריט
כולל הפניות לדפי אינטרנט שאולי שימשו ליצירתai_overview- domainסוג: string | null
שם הדומיין של ההפניה
- positionסוג: string | null
יישור הרכיב ב-SERP
יכול לקבל את הערכים הבאים:left,right - sourceסוג: string | null
שם המקור או הכותרת של ההפניה
- textסוג: string | null
הטקסט של הרכיב
- titleסוג: string | null
טקסט העוגן של הקישור
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת ה-URL של הקישור
- typeסוג: string | null
סוג הרכיב
- xpathסוג: string | null
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שמוחזרו במערך
items - keywordסוג: string | null
מילת המפתח שהתקבלה במערך POST
מילת המפתח מוחזרת עם קידוד %## מפוענח (הסמל '+' יפענח לרווח) - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- refinementסוג: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips שבבי עידון חיפוש
במקרה זה, הערך יהיהnull- itemsסוג: array (object | null)[] | null
הפריטים של הרכיב
- domainסוג: string | null
דומיין ב-SERP
- optionsסוג: array (object | null)[] | null
אפשרויות עידון חיפוש נוספות
- domainסוג: string | null
דומיין ב-SERP
- titleסוג: string | null
הכותרת של הרכיב
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL של החיפוש עם פרמטרי עידון
- titleסוג: string | null
הכותרת של הרכיב
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL של החיפוש עם פרמטרי עידון
- typeסוג: string | null
סוג הרכיב
- xpathסוג: string | null
ה-XPath של הרכיב
- seסוג: string | null
_domain דומיין מנוע החיפוש במערך POST
- seסוג: integer | null פורמט: int64
_results _count המספר הכולל של תוצאות ב-SERP
- spellסוג: object | null · Response36Afe1097B20_SpellInfo
תיקון אוטומטי של מנוע החיפוש
אם מנוע החיפוש סיפק תוצאות עבור מילת מפתח שתוקנה, נציין את מילת המפתח שתוקנה על ידי מנוע החיפוש ואת סוג התיקון האוטומטי;
במקרה זה, הערך יהיהnull- keywordסוג: string | null
מילת מפתח שהתקבלה כתוצאה מתיקון אוטומטי של מנוע החיפוש התוצאות יסופקו עבור מילת המפתח המתוקנת
- typeסוג: string | null
סוג התיקון האוטומטי ערכים אפשריים: did_you_mean, showing_results_for, no_results_found_for, including_results_for הערה: Yahoo ו-Yandex תומכים רק בסוג התיקון האוטומטי הבא: including_results_for
- typeסוג: string | null
סוג הרכיב
- resultסוג: integer | null פורמט: int64
_count מספר הפריטים במערך result
- statusסוג: integer | null
_code קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- statusסוג: string | null
_message הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- timeסוג: string | null
זמן ביצוע, בשניות
- סוג: integer | null פורמט: int64tasks
_count מספר המשימות במערך tasks
- סוג: integer | null פורמט: int64tasks
_error מספר המשימות במערך tasks שהוחזרו עם שגיאה
- סוג: string | nulltime
זמן ביצוע כולל, בשניות
- סוג: string | nullversion
הגרסה הנוכחית של ה-API
application/json - 400
לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
- 401
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"page": null,
"position": null,
"xpath": null,
"markdown": null,
"items": [
"[Max Depth Exceeded]"
],
"references": [
"[Max Depth Exceeded]"
],
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}