Lấy kết quả đánh giá mở rộng Google của Business Data theo id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Lấy kết quả đánh giá mở rộng Google của Business Data theo id
Lấy kết quả đã xếp hàng của toàn bộ lịch sử đánh giá Google cho một doanh nghiệp, vượt qua trang đầu mà endpoint tiêu chuẩn trả về, theo id. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong tasks[0].result, kết quả trong tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. ⚠️ Kích thước tỉ lệ với độ sâu đặt lúc gửi và không thể thu hẹp ở đây.
Tham chiếu giá
- Cách tính: chi phí phản hồi được báo cáo.
- Ước tính tham chiếu mỗi yêu cầu: 0,012 USD.
- Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo200
- Kiểu: number | null Định dạng: doublecost
tổng chi phí tác vụ, USD
- Kiểu: integer | nullstatus
_code mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- Kiểu: string | nullstatus
_message thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- Kiểu: array (object | null)[] | nulltasks
mảng tác vụ
- Kiểu: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo
- costKiểu: number | null Định dạng: double
tổng chi phí tác vụ, USD
- dataKiểu: object | null
chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST
- propertyKiểu: object | null
Name
- idKiểu: string | null
mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID
- pathKiểu: array (string | null)[] | null
Đường dẫn URL
- resultKiểu: array (object | null)[] | null
mảng kết quả
- checkKiểu: string | null
_url URL trực tiếp đến kết quả công cụ tìm kiếm
bạn có thể dùng URL này để đảm bảo chúng tôi đã cung cấp kết quả chính xác - cidKiểu: string | null
- datetimeKiểu: string | null
ngày và giờ nhận được kết quả
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - featureKiểu: string | null
_id - itemsKiểu: array (object | null)[] | null
các đánh giá được tìm thấy
bạn có thể lấy thêm kết quả bằng cách dùng tham sốdepthkhi tạo tác vụ- imagesKiểu: array (object | null)[] | null
hình ảnh do người đánh giá gửi
- altKiểu: string | null
thẻ alt của hình ảnh
- imageKiểu: string | null
_url URL của hình ảnh
URL dẫn đến hình ảnh trên nguồn gốc hoặc bộ lưu trữ DataForSEO (trong trường hợp nguồn gốc không khả dụng) - typeKiểu: string | null
loại phần tử
- urlKiểu: string | null
URL liên quan
- localKiểu: boolean | null
_guide cho biết người đánh giá có trạng thái 'local guide' hay không
- originalKiểu: string | null
_owner _answer văn bản gốc của phản hồi từ chủ doanh nghiệp
phản hồi gốc cho đánh giá, không áp dụng dịch tự động - originalKiểu: string | null
_review _text nội dung gốc của đánh giá
nội dung gốc của đánh giá, không áp dụng dịch tự động - ownerKiểu: string | null
_answer văn bản phản hồi của chủ doanh nghiệp
phản hồi của chủ doanh nghiệp cho đánh giá - ownerKiểu: string | null
_time _ago thời điểm xuất bản
cho biết thời điểm (ở định dạng 'time ago') khi chủ doanh nghiệp gửi phản hồi cho đánh giá - ownerKiểu: string | null
_timestamp ngày và giờ chủ doanh nghiệp trả lời đánh giá
ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - photosKiểu: integer | null Định dạng: int64
_count tổng số ảnh do người đánh giá gửi
- positionKiểu: string | null
căn chỉnh của đánh giá trong SERP
có thể nhận các giá trị sau:right - profileKiểu: string | null
_image _url URL ảnh hồ sơ của người đánh giá
- profileKiểu: string | null
_name tên hồ sơ của người đánh giá
- profileKiểu: string | null
_url URL hồ sơ của người đánh giá
- rankKiểu: integer | null
_absolute thứ hạng tuyệt đối trong tất cả đánh giá được liệt kê
vị trí tuyệt đối trong tất cả đánh giá trên danh sách - rankKiểu: integer | null
_group vị trí trong một nhóm phần tử có cùng giá trị
type
vị trí của các phần tử có giá trịtypekhác nhau bị bỏ khỏirank_group - ratingKiểu: object | null · Response36Afe1097B20_RatingInfo
điểm xếp hạng do người đánh giá gửi
- ratingKiểu: integer | null
_max giá trị tối đa cho một rating_type
- ratingKiểu: string | null
_type loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax
- valueKiểu: number | null Định dạng: double
giá trị của xếp hạng
- votesKiểu: integer | null Định dạng: int64
_count số lượng phản hồi
- reviewKiểu: array (object | null)[] | null
_highlights điểm nổi bật của đánh giá
chứa các tiêu chí và đánh giá được làm nổi bật- assessmentKiểu: string | null
đánh giá tính năng
- featureKiểu: string | null
tính năng được đánh giá
- reviewKiểu: string | null
_id mã định danh duy nhất của một đánh giá trên Google
ví dụ:ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE - reviewKiểu: string | null
_text nội dung của đánh giá
- reviewKiểu: string | null
_url URL của đánh giá
- reviewsKiểu: integer | null Định dạng: int64
_count tổng số đánh giá mà người đánh giá đã gửi
- sourceKiểu: object | null · Response36Afe1097B20_Source
nguồn của đánh giá
chứa thông tin về nguồn nơi đánh giá được đăng- domainKiểu: string | null
tên miền của nguồn nơi đánh giá được đăng
- imageKiểu: string | null
hình ảnh nổi bật của nguồn
- titleKiểu: string | null
tên của nguồn nơi đánh giá được đăng
- timeKiểu: string | null
_ago thời điểm xuất bản
cho biết thời điểm (ở định dạng 'time ago') khi đánh giá được liệt kê - timestampKiểu: string | null
ngày và giờ khi đánh giá được xuất bản
ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - typeKiểu: string | null
loại phần tử
- xpathKiểu: string | null
- itemsKiểu: integer | null Định dạng: int64
_count số lượng mục đánh giá trong mảng kết quả
bạn có thể lấy thêm kết quả bằng cách dùng tham sốdepthkhi tạo tác vụ - keywordKiểu: string | null
từ khóa nhận được trong mảng POST
từ khóa được trả về với %## đã giải mã (ký tự cộng '+' sẽ được giải mã thành dấu cách) - languageKiểu: string | null
_code mã ngôn ngữ trong mảng POST
- locationKiểu: integer | null
_code mã vị trí trong mảng POST
- placeKiểu: string | null
_id - ratingKiểu: object | null · Response36Afe1097B20_RatingInfo
xếp hạng của cơ sở địa phương tương ứng
mức độ phổ biến dựa trên đánh giá và được hiển thị trong SERP- ratingKiểu: integer | null
_max giá trị tối đa cho một rating_type
- ratingKiểu: string | null
_type loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax
- valueKiểu: number | null Định dạng: double
giá trị của xếp hạng
- votesKiểu: integer | null Định dạng: int64
_count số lượng phản hồi
- reviewsKiểu: integer | null Định dạng: int64
_count tổng số đánh giá
- seKiểu: string | null
_domain tên miền công cụ tìm kiếm trong mảng POST
- subKiểu: string | null
_title phụ đề của phần tử 'reviews' trong SERP
thông tin bổ sung (ví dụ: địa chỉ) về phần tử 'reviews' mà đánh giá được thu thập - titleKiểu: string | null
tiêu đề của phần tử 'reviews' trong SERP
tên của cơ sở địa phương mà đánh giá được thu thập - typeKiểu: string | null
loại phần tử
- resultKiểu: integer | null Định dạng: int64
_count số phần tử trong mảng kết quả
- statusKiểu: integer | null
_code mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- statusKiểu: string | null
_message thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- timeKiểu: string | null
thời gian thực thi, giây
- Kiểu: integer | null Định dạng: int64tasks
_count số lượng tác vụ trong mảng tasks
- Kiểu: integer | null Định dạng: int64tasks
_error số lượng tác vụ trong mảng tasks được trả về kèm lỗi
- Kiểu: string | nulltime
tổng thời gian thực thi, giây
- Kiểu: string | nullversion
phiên bản hiện tại của API
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
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]"
}
]
}
]
}
]
}