Tác vụ tìm kiếm khách sạn Google trực tiếp
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Tác vụ tìm kiếm khách sạn Google trực tiếp
Tìm kiếm Google Hotels các cơ sở phù hợp với truy vấn, kèm ngày và số khách. Đượ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. Đây là cách tìm khách sạn mà các endpoint thông tin cần id; post_dataforseo_business_google_hotel_info_live là chế độ xem chi tiết.
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,2428 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: array (object | null)[]
- adultsKiểu: integer | null
số người lớn
trường tùy chọn
nếu bạn không chỉ định trường này, giá trị mặc định2sẽ được áp dụng;
lưu ý bạn có thể chỉ định tối đa 6 người bao gồm cả người lớn và trẻ em
ví dụ:1 - amenitiesKiểu: array string[] | null
tiện nghi khách sạn
trường tùy chọn
bạn có thể dùng trường này để chỉ định các tiện nghi khách sạn khác nhau
ví dụ:[
"free_parking",
"pets_allowed"
]
giá trị khả dụng:"air_conditioning",<br>"all_inclusive_available",<br>"bar",<br>"free_breakfast",<br>"fitness_center",<br>"kid_friendly",<br>"free_parking",<br>"pets_allowed",<br>"pool",<br>"restaurant",<br>"room_service",<br>"spa",<br>"free_wifi",<br>"parking",<br>"indoor_pool",<br>"outdoor_pool",<br>"wheelchair_accessible",<br>"beach_access" - checkKiểu: string | null
_in ngày nhận phòng
trường tùy chọn
nếu bạn không chỉ định trường này, mặc định sẽ dùng ngày mai;
định dạng ngày:"yyyy-mm-dd"
ví dụ:"2019-01-15"
Lưu ý: giá trị không được trước ngày hôm nay - checkKiểu: string | null
_out ngày trả phòng
trường tùy chọn
nếu bạn không chỉ định trường này, hệ thống của chúng tôi sẽ mặc định áp dụng ngày sau hai ngày kể từ bây giờ;
định dạng ngày:"yyyy-mm-dd"
ví dụ:"2019-01-15"
Lưu ý: giá trị không được nhỏ hơn hoặc bằngcheck_in;
khoảng cách giữa giá trịcheck_invàcheck_outkhông được vượt quá 30 ngày - childrenKiểu: array string[] | null
số lượng và độ tuổi trẻ em
trường tùy chọn
nếu bạn không chỉ định trường này, sẽ không có trẻ em nào trong tìm kiếm;
độ tuổi trẻ em có thể từ0đến17;
lưu ý bạn có thể chỉ định tối đa 6 người bao gồm cả người lớn và trẻ em
đặt giá trị sau nếu bạn muốn bao gồm một trẻ 14 tuổi:[14]
đặt giá trị sau nếu bạn muốn bao gồm một trẻ 13 tuổi và một trẻ 8 tuổi:[13,8] - currencyKiểu: string | null
tiền tệ
trường tùy chọn
ví dụ:"USD" - depthKiểu: integer | null
độ sâu phân tích
trường tùy chọn
số kết quả trong Google Hotels
giá trị mặc định:18kết quả tự nhiên
giá trị tối đa:140
Lưu ý: tài khoản của bạn sẽ bị tính phí theo từng 18 kết quả tự nhiên bất kể danh sách trả phí trong phản hồi;
do đó, đặt độ sâu trên18có thể phát sinh thêm phí nếu Google Hotels trả về hơn 18 kết quả;
nếu độ sâu đã chỉ định cao hơn số kết quả trong phản hồi, phần chênh lệch sẽ được tự động hoàn lại vào số dư tài khoản của bạn - freeKiểu: boolean | null
_cancellation khách sạn có hủy miễn phí
trường tùy chọn
đặt trường này thànhtruenếu bạn muốn lấy danh sách khách sạn có hủy đặt phòng miễn phí
giá trị mặc định:false - isKiểu: boolean | null
_vacation _rentals tìm kiếm chỗ nghỉ cho thuê kỳ nghỉ
trường tùy chọn
đặt trường này thànhtruenếu bạn muốn lấy danh sách chỗ nghỉ cho thuê kỳ nghỉ thay vì khách sạn
giá trị mặc định:false - keywordKiểu: string | null
từ khóa
trường tùy chọn
từ khóa bạn chỉ định được dùng để tìm danh sách khách sạn;
nếu bạn không dùng trường này, chúng tôi sẽ trả về danh sách khách sạn tìm thấy tại vị trí đã chỉ định;
bạn có thể chỉ định tối đa 700 ký tự trong trườngkeyword
mọi %## sẽ được giải mã (ký tự ‘+’ cũng sẽ được giải mã thành ký tự khoảng trắng)
nếu bạn cần dùng ký tự “%” chokeyword, hãy chỉ định dưới dạng “%25”;
Lưu ý: để có kết quả tìm kiếm chính xác, tên vị trí sẽ được tự động nối vào từ khóatìm hiểu thêm về quy tắc và giới hạn của các trường
keywordvàkeywordstrong API DataForSEO tại bài viết Trung tâm trợ giúp này - languageKiểu: string
_code mã ngôn ngữ của công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlanguage_name
nếu bạn dùng trường này, bạn không cần chỉ địnhlanguage_name
bạn có thể nhận danh sách ngôn ngữ khả dụng cùnglanguage_codecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/business_data/google/languages
ví dụ:en - languageKiểu: string
_name tên đầy đủ của ngôn ngữ công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlanguage_code
nếu bạn dùng trường này, bạn không cần chỉ địnhlanguage_code
bạn có thể nhận danh sách ngôn ngữ khả dụng vớilanguage_namebằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/business_data/google/languages
ví dụ:English - locationKiểu: integer
_code mã vị trí của công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlocation_namehoặclocation_coordinate
nếu bạn dùng trường này, bạn không cần chỉ địnhlocation_namehoặclocation_coordinate
bạn có thể nhận danh sách vị trí khả dụng vớilocation_codebằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/business_data/google/locations
ví dụ:2840 - locationKiểu: string
_coordinate tọa độ GPS của một vị trí
trường bắt buộc nếu bạn không chỉ địnhlocation_namehoặclocation_code
nếu bạn dùng trường này, bạn không cần chỉ địnhlocation_namehoặclocation_code
tham sốlocation_coordinatephải được chỉ định ở định dạng "latitude,longitude"
số chữ số thập phân tối đa cho "latitude" và "longitude": 7
Lưu ý: nếu tọa độ được dùng để đặt vị trí, tìm kiếm sẽ diễn ra tại khu dân cư gần nhất
ví dụ:53.476225,-2.243572 - locationKiểu: string
_name tên đầy đủ của vị trí công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlocation_codehoặclocation_coordinate
nếu bạn dùng trường này, bạn không cần chỉ địnhlocation_codehoặclocation_coordinate
bạn có thể nhận danh sách vị trí khả dụng vớilocation_namebằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/business_data/google/locations
ví dụ:London,England,United Kingdom
Lưu ý: để có kết quả tìm kiếm chính xác,location_namebạn chỉ định sẽ được tự động nối vào từ khóa - maxKiểu: integer | null
_price giá tối đa mỗi đêm
trường tùy chọn
tiền tệ của giá trị này phụ thuộc vào trườngcurrency
ví dụ:600 - minKiểu: integer | null
_price giá tối thiểu mỗi đêm
trường tùy chọn
tiền tệ của giá trị này phụ thuộc vào trườngcurrency
ví dụ:100 - minKiểu: number | null
_rating điểm đánh giá tối thiểu
trường tùy chọn
bạn có thể dùng trường này để chỉ định điểm đánh giá của khách cao hơn một giá trị nhất định
ví dụ:2.5 - searchKiểu: boolean | null
_this _area hiển thị khách sạn trong khu vực hiển thị
trường tùy chọn
có thể nhận các giá trị:true,false
giá trị mặc định:true
nếu đặt thànhfalse, chế độsearch_this_areasẽ bị tắt
Lưu ý: nếu chế độsearch_this_areabị tắt,location_namesẽ không được nối vàokeywordkhi tìm kiếm
tìm hiểu thêm về tham số này tại Trung tâm trợ giúp của chúng tôi - sortKiểu: string | null
_by tham số sắp xếp kết quả
trường tùy chọn
bạn có thể dùng trường này để sắp xếp kết quả
các kiểu sắp xếp khả dụng:relevance– sắp xếp theo mức liên quan cao nhấtlowest_price– sắp xếp theo giá thấp nhấthighest_rating– sắp xếp theo điểm đánh giá cao nhấtmost_reviewed– sắp xếp theo số đánh giá nhiều nhất
giá trị mặc định:relevance - starsKiểu: array string[] | null
số sao khách sạn
trường tùy chọn
đặt trường này thành[5]nếu bạn chỉ muốn lấy danh sách khách sạn 5 sao
ví dụ:[3,4,5] - tagKiểu: string | null
mã định danh tác vụ do người dùng xác định
trường tùy chọn
giới hạn ký tự là 255
bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả
bạn sẽ thấy giá trịtagđã chỉ định trong đối tượngdatacủa phản hồi
- Kiểu: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo200
- 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_BusinessDataGoogleHotelSearchesLiveTaskInfo
- 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 - 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 - itemsKiểu: array (object | null)[] | null
các loại mục gặp phải
các loại kết quả công cụ tìm kiếm gặp trong mảngitems;
các loại mục khả dụng:hotel_search_item- hotelKiểu: string | null
_identifier mã định danh duy nhất của thực thể khách sạn trong tìm kiếm Google
ví dụ:CgoI-KWyzenM_MV3EAE - isKiểu: boolean | null
_paid cho biết đây là danh sách khách sạn trả phí
nếutrue,hotel_search_itemliên quan là quảng cáo trả phí
nếufalse,hotel_search_itemliên quan là danh sách khách sạn organic - locationKiểu: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo
tọa độ GPS vị trí của khách sạn
- latitudeKiểu: number | null
tọa độ vĩ độ của khách sạn trong google maps
ví dụ:"latitude": 51.584091 - longitudeKiểu: number | null
tọa độ kinh độ của khách sạn trong google maps
ví dụ:"longitude": -0.31365919999999997
- overviewKiểu: array (string | null)[] | null
_images hình ảnh nổi bật cho khách sạn
- pricesKiểu: object | null · Response36Afe1097B20_HotelPriceInfo
giá khách sạn
- checkKiểu: string | null
_in ngày và giờ nhận phòng
ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - checkKiểu: string | null
_out ngày và giờ trả phòng
ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - currencyKiểu: string | null
đơn vị tiền tệ của giá
USDđược áp dụng theo mặc định, trừ khi được chỉ định trong mảng POST - discountKiểu: string | null
_text văn bản về khoản giảm giá được áp dụng
- itemsKiểu: array (object | null)[] | null
các loại mục gặp phải
các loại kết quả công cụ tìm kiếm gặp trong mảngitems;
các loại mục khả dụng:hotel_search_item- currencyKiểu: string | null
đơn vị tiền tệ của giá
USDđược áp dụng theo mặc định, trừ khi được chỉ định trong mảng POST - domainKiểu: string | null
tên miền bên thứ ba tên miền của trang web bên thứ ba có thông tin giá
- freeKiểu: string | null
_cancellation _until ngày mà đến ngày đó vẫn còn hủy miễn phí ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” bằng null nếu không có hủy miễn phí cho các ngày đã chọn
- isKiểu: boolean | null
_paid cho biết đây là danh sách khách sạn trả phí
nếutrue,hotel_search_itemliên quan là quảng cáo trả phí
nếufalse,hotel_search_itemliên quan là danh sách khách sạn organic - offersKiểu: array (object | null)[] | null
ưu đãi giá nổi bật
- currencyKiểu: string | null
đơn vị tiền tệ của giá
USDđược áp dụng theo mặc định, trừ khi được chỉ định trong mảng POST - freeKiểu: string | null
_cancellation _until ngày mà đến ngày đó vẫn còn hủy miễn phí ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” bằng null nếu không có hủy miễn phí cho các ngày đã chọn
- maxKiểu: integer | null
_visitors số lượng khách tối đa số lượng khách tối đa mà ưu đãi giá áp dụng
- offerKiểu: array (string | null)[] | null
_images hình ảnh ưu đãi giá URL của các hình ảnh có trong ưu đãi giá
- priceKiểu: number | null
giá mỗi đêm
- titleKiểu: string | null
tiêu đề của khách sạn
- typeKiểu: string | null
loại phần tử
- urlKiểu: string | null
url của ưu đãi giá URL đến trang của trang web nơi ưu đãi giá xuất hiện
- officialKiểu: boolean | null
_site - priceKiểu: number | null
giá mỗi đêm
- titleKiểu: string | null
tiêu đề của khách sạn
- typeKiểu: string | null
loại phần tử
- urlKiểu: string | null
url trang bên thứ ba URL đến trang web bên thứ ba có thông tin giá
- priceKiểu: number | null
giá mỗi đêm
- priceKiểu: number | null Định dạng: int64
_without _discount giá đầy đủ mỗi đêm chưa áp dụng giảm giá
- pricesKiểu: array (object | null)[] | null
_by _dates - checkKiểu: string | null
_in _date - checkKiểu: string | null
_out _date - currencyKiểu: string | null
đơn vị tiền tệ của giá
USDđược áp dụng theo mặc định, trừ khi được chỉ định trong mảng POST - priceKiểu: number | null
giá mỗi đêm
- visitorsKiểu: integer | null
số lượng khách của khách sạn cho mức giá này
- reviewsKiểu: object | null · Response36Afe1097B20_HotelReviewInfo
đánh giá và thông tin xếp hạng của khách sạn
- mentionsKiểu: array (object | null)[] | null
đề cập khách sạn
thông tin về đánh giá khách sạn theo tiêu chí- negativeKiểu: integer | null Định dạng: int64
_count số đánh giá tiêu cực theo tiêu chí
- positiveKiểu: integer | null Định dạng: int64
_count số đánh giá tích cực theo tiêu chí
- positiveKiểu: number | null
_score điểm tích cực theo tiêu chí
- titleKiểu: string | null
tiêu đề của tiêu chí được đánh giá
- totalKiểu: integer | null Định dạng: int64
_count số lượng tất cả đánh giá theo tiêu chí
- visibleKiểu: boolean | null
_by _default phần tử hiển thị theo mặc định
cho biết phần tử đánh giá có hiển thị theo mặc định hay không
- otherKiểu: array (object | null)[] | null
_sites _reviews đánh giá trên các trang bên thứ ba
đánh giá từ các trang bên thứ ba- ratingKiểu: object | null · Response36Afe1097B20_RatingInfo
xếp hạng trong đánh giá
thông tin về xếp hạng được nêu trong đánh giá trên trang bên thứ ba- 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: string | null
_text văn bản đánh giá
nội dung của đánh giá - titleKiểu: string | null
tiêu đề đánh giá
chứa tên trang bên thứ ba nơi đánh giá xuất hiện lần đầu - urlKiểu: string | null
url đánh giá
URL tới trang bên thứ ba nơi đánh giá xuất hiện lần đầu
- ratingKiểu: object | null
_distribution phân bố xếp hạng theo lượt bình chọn
phân bố lượt bình chọn trên thang xếp hạng từ 1 đến 5- propertyKiểu: integer | null Định dạng: Int64
Name
- valueKiểu: number | null
xếp hạng khách sạn tổng thể dựa trên bình chọn của khách hàng
- votesKiểu: integer | null Định dạng: int64
_count số lượt bình chọn của khách hàng
số lượt bình chọn của khách hàng được đưa vào tính xếp hạng khách sạn
- starsKiểu: integer | null
hạng khách sạn
hạng từ 1 đến 5 sao - titleKiểu: string | null
tiêu đề của khách sạn
- typeKiểu: string | null
loại phần tử
- itemsKiểu: integer | null Định dạng: int64
_count các loại mục
số lượng mục trong mảngitems - 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
- 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/hotel_searches/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"keyword": "cheap hotel",
"check_in": "2023-06-01",
"check_out": "2023-06-30",
"currency": "USD",
"adults": 2,
"children": [
"14"
],
"sort_by": "highest_rating",
"priority": 2,
"tag": "example"
}
]'
{
"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,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"items_count": null,
"items": [
{
"type": null,
"hotel_identifier": null,
"title": null,
"stars": null,
"is_paid": null,
"location": "[Max Depth Exceeded]",
"reviews": "[Max Depth Exceeded]",
"overview_images": [
"[Max Depth Exceeded]"
],
"prices": "[Max Depth Exceeded]"
}
]
}
]
}
]
}