DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
קבלת תוצאות Google Extended Reviews לפי id
מאחזר את היסטוריית הביקורות המלאה של Google שנכנסה לתור עבור עסק, מעבר לעמוד הראשון שנקודת הקצה הרגילה מחזירה, לפי id. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. ⚠️ הגודל נקבע לפי depth שהוגדר בשליחה ואי אפשר לצמצם אותו בזמן האחזור.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.012 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo
- 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 ישירה לתוצאות מנוע החיפוש
אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות - cidסוג: string | null
- datetimeסוג: string | null
התאריך והשעה שבהם התוצאה התקבלה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - featureסוג: string | null
_id - itemsסוג: array (object | null)[] | null
ביקורות שנמצאו
אפשר לקבל תוצאות נוספות באמצעות הפרמטרdepthבעת הגדרת משימה- imagesסוג: array (object | null)[] | null
תמונות שהוגשו על ידי המבקר
- altסוג: string | null
תג alt של התמונה
- imageסוג: string | null
_url כתובת URL של התמונה
כתובת ה-URL שמובילה לתמונה במשאב המקורי או באחסון של DataForSEO (אם המקור המקורי אינו זמין) - typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL רלוונטית
- localסוג: boolean | null
_guide מציין אם למבקר יש סטטוס 'מדריך מקומי'
- originalסוג: string | null
_owner _answer הטקסט המקורי של תגובת הבעלים
התגובה המקורית לביקורת, ללא תרגום אוטומטי - originalסוג: string | null
_review _text התוכן המקורי של הביקורת
התוכן המקורי של הביקורת, ללא תרגום אוטומטי - ownerסוג: string | null
_answer הטקסט של תגובת הבעלים
תגובת הבעלים לביקורת - ownerסוג: string | null
_time _ago זמן הפרסום
מציין את הזמן (בפורמט 'לפני זמן') שבו הבעלים שלח את תגובתו לביקורת - ownerסוג: string | null
_timestamp התאריך והשעה של תגובת הבעלים לביקורת
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - photosסוג: integer | null פורמט: int64
_count המספר הכולל של תמונות שהוגשו על ידי המבקר
- positionסוג: string | null
יישור הביקורת ב-SERP
יכול לקבל את הערכים הבאים:right - profileסוג: string | null
_image _url כתובת URL של תמונת הפרופיל של המבקר
- profileסוג: string | null
_name שם הפרופיל של המבקר
- profileסוג: string | null
_url כתובת URL של הפרופיל של המבקר
- rankסוג: integer | null
_absolute דירוג מוחלט מבין כל הביקורות המופיעות ברשימה
מיקום מוחלט מבין כל הביקורות ברשימה - rankסוג: integer | null
_group מיקום בתוך קבוצת רכיבים עם ערכי
typeזהים
מיקומים של רכיבים עם ערכיtypeשונים מושמטים מ-rank_group - ratingסוג: object | null · Response36Afe1097B20_RatingInfo
ציון הדירוג כפי שנשלח על ידי המבקר
- ratingסוג: integer | null
_max הערך המקסימלי של rating_type
- ratingסוג: string | null
_type סוג הדירוג כאן אפשר למצוא את הרכיבים הבאים: Max5, Percents, CustomMax
- valueסוג: number | null פורמט: double
ערך הדירוג
- votesסוג: integer | null פורמט: int64
_count כמות המשוב
- reviewסוג: array (object | null)[] | null
_highlights עיקרי הביקורת
מכיל קריטריונים והערכות מודגשים של הביקורת- assessmentסוג: string | null
הערכת המאפיין
- featureסוג: string | null
המאפיין שנבדק
- reviewסוג: string | null
_id המזהה הייחודי של ביקורת ב-Google
דוגמה:ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE - reviewסוג: string | null
_text התוכן של הביקורת
- reviewסוג: string | null
_url כתובת ה-URL של הביקורת
- reviewsסוג: integer | null פורמט: int64
_count המספר הכולל של ביקורות שהוגשו על ידי המבקר
- sourceסוג: object | null · Response36Afe1097B20_Source
מקור הביקורת
מכיל מידע על המקור שבו פורסמה הביקורת- domainסוג: string | null
הדומיין של המקור שבו פורסמה הביקורת
- imageסוג: string | null
התמונה המוצגת של המקור
- titleסוג: string | null
שם המקור שבו פורסמה הביקורת
- timeסוג: string | null
_ago זמן הפרסום
מציין את הזמן (בפורמט 'לפני זמן') שבו הביקורת הוצגה - timestampסוג: string | null
התאריך והשעה שבהם פורסמה ביקורת
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - typeסוג: string | null
סוג הרכיב
- xpathסוג: string | null
- itemsסוג: integer | null פורמט: int64
_count מספר פריטי הביקורות במערך התוצאות
אפשר לקבל תוצאות נוספות באמצעות הפרמטרdepthבעת הגדרת משימה - keywordסוג: string | null
מילת מפתח שהתקבלה במערך POST
מילת המפתח מוחזרת עם פענוח %## (התו '+' יפענח לרווח) - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- placeסוג: string | null
_id - ratingסוג: object | null · Response36Afe1097B20_RatingInfo
הדירוג של המוסד המקומי המתאים
שיעור הפופולריות בהתבסס על ביקורות ומוצג ב-SERP- ratingסוג: integer | null
_max הערך המקסימלי של rating_type
- ratingסוג: string | null
_type סוג הדירוג כאן אפשר למצוא את הרכיבים הבאים: Max5, Percents, CustomMax
- valueסוג: number | null פורמט: double
ערך הדירוג
- votesסוג: integer | null פורמט: int64
_count כמות המשוב
- reviewsסוג: integer | null פורמט: int64
_count מספר הביקורות הכולל
- seסוג: string | null
_domain דומיין מנוע החיפוש במערך POST
- subסוג: string | null
_title כותרת המשנה של רכיב 'reviews' ב-SERP
מידע נוסף (למשל כתובת) על רכיב 'reviews' שעבורו נאספות הביקורות - titleסוג: string | null
הכותרת של רכיב 'reviews' ב-SERP
השם של המוסד המקומי שעבורו נאספות הביקורות - 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/business_data/google/extended_reviews/task_get/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,
"title": null,
"sub_title": null,
"rating": {
"rating_type": null,
"value": null,
"votes_count": null,
"rating_max": null
},
"feature_id": null,
"place_id": null,
"cid": null,
"reviews_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"xpath": null,
"review_text": null,
"original_review_text": null,
"time_ago": null,
"timestamp": null,
"rating": "[Max Depth Exceeded]",
"reviews_count": null,
"photos_count": null,
"local_guide": null,
"profile_name": null,
"profile_url": null,
"review_url": null,
"profile_image_url": null,
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null,
"review_id": null,
"images": [
"[Max Depth Exceeded]"
],
"review_highlights": [
"[Max Depth Exceeded]"
],
"source": "[Max Depth Exceeded]"
}
]
}
]
}
]
}