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]"
]
}
]
}
]
}
]
}