DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ตั้งค่างานค้นหาโรงแรม Google
เข้าคิวการค้นหา Google Hotels และคืนค่า id ของงาน ห่อหุ้มในซองของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code - คำขอที่ถูกปฏิเสธยังคงคืนค่า HTTP 200 ดึงผลด้วย get_dataforseo_business_google_hotel_searches_fetch
ข้อมูลอ้างอิงราคา
- การวัดปริมาณ: ต้นทุนการตอบกลับที่รายงาน
- ประมาณการคำขออ้างอิง: USD 0.2428
- ตัวคูณลูกค้าอ้างอิง: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่ตัดบัญชีของลูกค้าแล้ว
เป็นเพียงข้อมูลเมตาอ้างอิง ไม่ใช่ใบเสนอราคาของบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตทรัพยากรไม่ใช่เครดิต Felo การเรียกเก็บเงินขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo
- ประเภท: array (object | null)[]
- adultsประเภท: integer | null
จำนวนผู้ใหญ่
ฟิลด์ไม่บังคับ
หากไม่ได้ระบุฟิลด์นี้ ระบบจะใช้ค่าเริ่มต้น2;
โปรดทราบว่าสามารถระบุได้สูงสุด 6 คน รวมทั้งผู้ใหญ่และเด็ก
ตัวอย่าง:1 - amenitiesประเภท: array string[] | null
สิ่งอำนวยความสะดวกของโรงแรม
ฟิลด์ไม่บังคับ
คุณสามารถใช้ฟิลด์นี้เพื่อระบุสิ่งอำนวยความสะดวกต่าง ๆ ของโรงแรม
ตัวอย่าง:[
"free_parking",
"pets_allowed"
]
ค่าที่เป็นไปได้:"air_conditioning",
"all_inclusive_available",
"bar",
"free_breakfast",
"fitness_center",
"kid_friendly",
"free_parking",
"pets_allowed",
"pool",
"restaurant",
"room_service",
"spa",
"free_wifi",
"parking",
"indoor_pool",
"outdoor_pool",
"wheelchair_accessible",
"beach_access" - checkประเภท: string | null
_in วันที่เช็กอิน
ฟิลด์ไม่บังคับ
หากไม่ได้ระบุฟิลด์นี้ ระบบจะใช้วันพรุ่งนี้เป็นค่าเริ่มต้น;
รูปแบบวันที่:"yyyy-mm-dd"
ตัวอย่าง:"2019-01-15"
หมายเหตุ: ค่าต้องไม่ก่อนวันที่วันนี้ - checkประเภท: string | null
_out วันที่เช็กเอาต์
ฟิลด์ไม่บังคับ
หากไม่ได้ระบุฟิลด์นี้ ระบบจะใช้วันที่สองวันนับจากนี้เป็นค่าเริ่มต้น;
รูปแบบวันที่:"yyyy-mm-dd"
ตัวอย่าง:"2019-01-15"
หมายเหตุ: ค่าต้องไม่น้อยกว่าหรือเท่ากับcheck_in;
ช่วงระหว่างค่าcheck_inและcheck_outต้องไม่เกิน 30 วัน - childrenประเภท: array string[] | null
จำนวนและอายุของเด็ก
ฟิลด์ไม่บังคับ
หากไม่ได้ระบุฟิลด์นี้ จะไม่มีเด็กในการค้นหา;
อายุของเด็กอยู่ระหว่าง0ถึง17;
โปรดทราบว่าสามารถระบุได้สูงสุด 6 คน รวมทั้งผู้ใหญ่และเด็ก
กำหนดค่าต่อไปนี้หากต้องการรวมเด็กอายุ 14 ปีหนึ่งคน:[14]
กำหนดค่าต่อไปนี้หากต้องการรวมเด็กอายุ 13 ปีหนึ่งคนและเด็กอายุ 8 ปีหนึ่งคน:[13,8] - currencyประเภท: string | null
สกุลเงิน
ฟิลด์ไม่บังคับ
ตัวอย่าง:"USD" - depthประเภท: integer | null
ความลึกในการดึงข้อมูล
ฟิลด์ไม่บังคับ
จำนวนผลลัพธ์ใน Google Hotels
ค่าเริ่มต้น:18ผลลัพธ์ออร์แกนิก
ค่าสูงสุด:140
หมายเหตุ: บัญชีของคุณจะถูกเรียกเก็บเงินต่อผลลัพธ์ออร์แกนิกทุก 18 รายการ โดยไม่คำนึงถึงรายการที่เสียค่าใช้จ่ายในการตอบกลับ;
ดังนั้น การกำหนดความลึกเกิน18อาจทำให้มีค่าใช้จ่ายเพิ่มเติมหาก Google Hotels ส่งคืนผลลัพธ์มากกว่า 18 รายการ;
หากความลึกที่กำหนดสูงกว่าจำนวนผลลัพธ์ในการตอบกลับ ส่วนต่างจะถูกคืนเงินเข้าบัญชีของคุณโดยอัตโนมัติ - freeประเภท: boolean | null
_cancellation โรงแรมที่ยกเลิกได้ฟรี
ฟิลด์ไม่บังคับ
ตั้งฟิลด์นี้เป็นtrueหากต้องการรับรายการโรงแรมที่ยกเลิกการจองได้ฟรี
ค่าเริ่มต้น:false - isประเภท: boolean | null
_vacation _rentals ค้นหาที่พักให้เช่าระยะสั้น
ฟิลด์ไม่บังคับ
ตั้งฟิลด์นี้เป็นtrueหากต้องการรับรายการที่พักให้เช่าระยะสั้นแทนโรงแรม
ค่าเริ่มต้น:false - keywordประเภท: string | null
คีย์เวิร์ด
ฟิลด์ไม่บังคับ
คีย์เวิร์ดที่ระบุจะใช้ค้นหารายการโรงแรม;
หากไม่ใช้ฟิลด์นี้ เราจะส่งคืนรายการโรงแรมที่พบในสถานที่ที่ระบุ;
ระบุได้ สูงสุด 700 อักขระ ในฟิลด์keyword
%## ทั้งหมดจะถูกถอดรหัส (อักขระ ‘+’ จะถูกถอดรหัสเป็นอักขระเว้นวรรค)
หากต้องการใช้ อักขระ “%” ในkeywordให้ระบุเป็น “%25”;
หมายเหตุ: เพื่อให้ได้ผลการค้นหาที่แม่นยำ ชื่อสถานที่จะถูกต่อท้ายคีย์เวิร์ดโดยอัตโนมัติดูข้อมูลเพิ่มเติมเกี่ยวกับกฎและข้อจำกัดของฟิลด์
keywordและkeywordsใน DataForSEO APIs ในบทความ Help Center นี้ - languageประเภท: string
_code รหัสภาษาของเครื่องมือค้นหา
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlanguage_name
หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุlanguage_name
คุณสามารถรับรายการภาษาที่ใช้ได้พร้อมlanguage_codeได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/business_data/google/languages
ตัวอย่าง:en - languageประเภท: string
_name ชื่อเต็มของภาษาของเครื่องมือค้นหา
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlanguage_code
หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุlanguage_code
คุณสามารถรับรายการภาษาที่ใช้ได้พร้อมlanguage_nameได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/business_data/google/languages
ตัวอย่าง:English - locationประเภท: integer
_code รหัสสถานที่ของเครื่องมือค้นหา
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlocation_nameหรือlocation_coordinate
หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุlocation_nameหรือlocation_coordinate
คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อมlocation_codeได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/business_data/google/locations
ตัวอย่าง:2840 - locationประเภท: string
_coordinate พิกัด GPS ของสถานที่
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlocation_nameหรือlocation_code
หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุlocation_nameหรือlocation_code
พารามิเตอร์location_coordinateต้องระบุในรูปแบบ "latitude,longitude"
จำนวนตำแหน่งทศนิยมสูงสุดสำหรับ "latitude" และ "longitude": 7
หมายเหตุ: หากใช้พิกัดเพื่อกำหนดสถานที่ การค้นหาจะเกิดขึ้นในชุมชนที่ใกล้ที่สุด;
ตัวอย่าง:53.476225,-2.243572 - locationประเภท: string
_name ชื่อเต็มของสถานที่ของเครื่องมือค้นหา
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlocation_codeหรือlocation_coordinate
หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุlocation_codeหรือlocation_coordinate
คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อมlocation_nameได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/business_data/google/locations
ตัวอย่าง:London,England,United Kingdom
หมายเหตุ: เพื่อให้ได้ผลการค้นหาที่แม่นยำlocation_nameที่ระบุจะถูกต่อท้ายคีย์เวิร์ดโดยอัตโนมัติ - maxประเภท: integer | null
_price ราคาสูงสุดต่อคืน
ฟิลด์ไม่บังคับ
สกุลเงินของค่านี้ขึ้นอยู่กับฟิลด์currency
ตัวอย่าง:600 - minประเภท: integer | null
_price ราคาต่ำสุดต่อคืน
ฟิลด์ไม่บังคับ
สกุลเงินของค่านี้ขึ้นอยู่กับฟิลด์currency
ตัวอย่าง:100 - minประเภท: number | null
_rating คะแนนขั้นต่ำ
ฟิลด์ไม่บังคับ
คุณสามารถใช้ฟิลด์นี้เพื่อระบุคะแนนจากผู้เข้าพักที่สูงกว่าค่าที่กำหนด
ตัวอย่าง:2.5 - pingbackประเภท: string | null
_url URL แจ้งเตือนเมื่องานเสร็จสิ้น
ฟิลด์ที่ไม่บังคับ
เมื่องานเสร็จสิ้น เราจะแจ้งให้คุณทราบผ่านคำขอ GET ที่ส่งไปยัง URL ที่คุณระบุ
คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร$idและ ‘$tag’ เป็นตัวแปร$tagที่เข้ารหัส URL เราจะกำหนดค่าที่จำเป็นก่อนส่งคำขอ
ตัวอย่าง:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
หมายเหตุ: อักขระพิเศษในpingback_urlจะถูกเข้ารหัส URL;
กล่าวคือ อักขระ#จะถูกเข้ารหัสเป็น%23 - postbackประเภท: string | null
_url URL สำหรับส่งผลลัพธ์ของงาน
ฟิลด์ที่ไม่บังคับ
เมื่องานเสร็จสิ้น เราจะส่งคำขอ POST พร้อมผลลัพธ์ที่บีบอัดในรูปแบบgzipไปยังpostback_urlที่คุณระบุ
คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร$idและ ‘$tag’ เป็นตัวแปร$tagที่เข้ารหัส URL เราจะกำหนดค่าที่จำเป็นก่อนส่งคำขอ
ตัวอย่าง:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
หมายเหตุ: อักขระพิเศษในpostback_urlจะถูกเข้ารหัส URL;
กล่าวคือ อักขระ#จะถูกเข้ารหัสเป็น%23 - priorityประเภท: integer | null
- searchประเภท: boolean | null
_this _area - sortประเภท: string | null
_by พารามิเตอร์การเรียงลำดับผลลัพธ์
ฟิลด์ไม่บังคับ
คุณสามารถใช้ฟิลด์นี้เพื่อเรียงลำดับผลลัพธ์
ประเภทการเรียงลำดับที่เป็นไปได้:relevance– เรียงตามความเกี่ยวข้องมากที่สุดlowest_price– เรียงตามราคาต่ำสุดhighest_rating– เรียงตามคะแนนสูงสุดmost_reviewed– เรียงตามจำนวนรีวิวมากที่สุด
ค่าเริ่มต้น:relevance - starsประเภท: array string[] | null
ระดับดาวของโรงแรม
ฟิลด์ไม่บังคับ
ตั้งฟิลด์นี้เป็น[5]หากต้องการรับรายการโรงแรม 5 ดาวเท่านั้น
ตัวอย่าง:[3,4,5] - tagประเภท: string | null
ตัวระบุงานที่ผู้ใช้กำหนด
ฟิลด์ไม่บังคับ
จำกัด 255 อักขระ
ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
คุณจะพบค่าtagที่ระบุในออบเจ็กต์dataของการตอบกลับ
- ประเภท: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo200
- ประเภท: number | null รูปแบบ: doublecost
ค่าใช้จ่ายรวมของงาน, USD
- ประเภท: integer | nullstatus
_code รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่
- ประเภท: string | nullstatus
_message ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่
- ประเภท: array (object | null)[] | nulltasks
อาร์เรย์ของงาน
- ประเภท: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
- costประเภท: number | null รูปแบบ: double
ค่าใช้จ่ายรวมของงาน, USD
- dataประเภท: object | null
มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST
- propertyประเภท: object | null
Name
- idประเภท: string | null
ตัวระบุงาน ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID
- pathประเภท: array (string | null)[] | null
พาธ URL
- resultประเภท: object | null
อาร์เรย์ของผลลัพธ์
ในกรณีนี้ ค่าจะเป็น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/hotel_searches/task_post \
--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": null
}
]
}