DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
קבלת תוצאות ביקורות Google לפי id
מאחזר ביקורות Google Business Profile שנכנסו לתור לפי id. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. ⚠️ הגודל נקבע לפי depth שהוגדר בשליחה ואי אפשר לצמצם אותו בזמן האחזור.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.012 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: object | null · Response36Afe1097B20_BusinessDataGoogleReviewsTaskGetResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_BusinessDataGoogleReviewsTaskGetTaskInfo
- 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
_language השפה המקורית של טקסט הביקורת
- 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 המספר הכולל של ביקורות שהוגשו על ידי המבקר
- 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/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,
"original_language": 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]"
]
}
]
}
]
}
]
}