DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
การค้นหายอดนิยม
คีย์เวิร์ดที่มีปริมาณการค้นหาสูงสุดในพื้นที่หนึ่ง โดยไม่กรองด้วยคำตั้งต้นหรือไซต์ แบ่งหน้าได้ด้วย limit, offset และ offset_token; ใช้โทเคนสำหรับหน้าที่เลยช่วงหน้าแรก ๆ ไป ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200 นี่คือปลายด้านการค้นพบของตระกูลนี้: ใช้เมื่อยังไม่มีคีย์เวิร์ดตั้งต้น แล้วค่อยแคบลงด้วย post_dataforseo_labs_google_keyword_ideas_live
ข้อมูลอ้างอิงราคา
- การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
- ค่าประมาณคำขออ้างอิง: USD 0.1356
- ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว
เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo
- ประเภท: array (object | null)[]
- filtersประเภท: array (object | null)[] | null
อาร์เรย์ของพารามิเตอร์การกรองผลลัพธ์
ฟิลด์ที่ไม่บังคับ
เพิ่มตัวกรองได้หลายรายการพร้อมกัน (สูงสุด 8 ตัวกรอง)
ต้องกำหนดโอเปอเรเตอร์ทางตรรกะand,orระหว่างเงื่อนไข
รองรับโอเปอเรเตอร์ต่อไปนี้:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
ใช้โอเปอเรเตอร์%ร่วมกับlikeและnot_likeรวมถึงilikeและnot_ilikeเพื่อจับคู่สตริงใด ๆ ที่มีอักขระศูนย์ตัวขึ้นไป
ตัวอย่าง:["keyword_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["keyword_info.cpc","<",0.5],
"or",["keyword_info.high_top_of_page_bid","<=",0.5]]]
ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองได้ที่ Dataforseo Labs - Filters หรือคู่มือ Help Center นี้ออบเจ็กต์ว่าง - ignoreประเภท: boolean | null
_synonyms ไม่สนใจคีย์เวิร์ดที่คล้ายกันมาก
ฟิลด์ที่ไม่บังคับ
หากตั้งค่าเป็นtrueจะคืนเฉพาะคีย์เวิร์ดหลัก และตัดคีย์เวิร์ดที่คล้ายกันมากทั้งหมดออก;
ค่าเริ่มต้น:false - includeประเภท: boolean | null
_clickstream _data รวมหรือตัดข้อมูลจากเมตริกที่อิงคลิกสตรีมในผลลัพธ์
ฟิลด์ที่ไม่บังคับ
หากตั้งค่าพารามิเตอร์เป็นtrueคุณจะได้รับฟิลด์clickstream_keyword_info,keyword_info_normalized_with_clickstreamและkeyword_info_normalized_with_bingในการตอบกลับ
ค่าเริ่มต้น:false
เมื่อเปิดใช้พารามิเตอร์นี้ จะถูกเรียกเก็บค่าบริการสองเท่าสำหรับคำขอดูข้อมูลเพิ่มเติมเกี่ยวกับการคำนวณเมตริกที่อิงคลิกสตรีมได้ในบทความ Help Center นี้
- includeประเภท: boolean | null
_serp _info รวมข้อมูลจาก SERP สำหรับแต่ละคีย์เวิร์ด
ฟิลด์ที่ไม่บังคับ
หากตั้งค่าเป็นtrueระบบจะคืนอาร์เรย์serp_infoที่มีข้อมูล SERP (จำนวนผลการค้นหา URL ที่เกี่ยวข้อง และฟีเจอร์ของ SERP) สำหรับทุกคีย์เวิร์ดในการตอบกลับ
ค่าเริ่มต้น:false - languageประเภท: string | null
_code รหัสภาษา
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlanguage_name
หมายเหตุ: ต้องระบุlanguage_nameหรือlanguage_codeอย่างใดอย่างหนึ่ง
คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อมlanguage_codeได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ตัวอย่าง:en - languageประเภท: string
_name ชื่อเต็มของภาษา
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlanguage_code
หมายเหตุ: ต้องระบุlanguage_nameหรือlanguage_codeอย่างใดอย่างหนึ่ง
คุณสามารถรับรายการภาษาที่ใช้ได้พร้อมlanguage_nameได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ตัวอย่าง:English - limitประเภท: integer | null
จำนวนคีย์เวิร์ดสูงสุดที่คืน
ฟิลด์ที่ไม่บังคับ
หมายเหตุ: คุณสามารถรับผลลัพธ์เกิน 1000 รายการได้โดยใช้offset_tokenที่ให้มาในการตอบกลับสำหรับแต่ละคำขอถัดไป
ค่าเริ่มต้น:1000
ค่าสูงสุด:1000 - locationประเภท: integer
_code รหัสสถานที่
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlocation_name
หมายเหตุ: ต้องระบุlocation_nameหรือlocation_codeอย่างใดอย่างหนึ่ง
คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อมlocation_codeได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ตัวอย่าง:2840 - locationประเภท: string
_name ชื่อเต็มของสถานที่
ฟิลด์ที่จำเป็นหากไม่ได้ระบุlocation_code
หมายเหตุ: ต้องระบุlocation_nameหรือlocation_codeอย่างใดอย่างหนึ่ง
คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อมlocation_nameได้โดยส่งคำขอแยกไปที่https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ตัวอย่าง:United Kingdom - offsetประเภท: integer | null
ออฟเซตในอาร์เรย์ผลลัพธ์ของคีย์เวิร์ดที่คืน
ฟิลด์ที่ไม่บังคับ
ค่าเริ่มต้น:0
หากระบุค่า10คีย์เวิร์ดสิบรายการแรกในอาร์เรย์ผลลัพธ์จะถูกข้ามไป และข้อมูลจะเริ่มจากคีย์เวิร์ดถัดไป
หมายเหตุ: แนะนำให้ใช้พารามิเตอร์นี้เมื่อดึงผลลัพธ์ไม่เกิน 10,000 รายการเท่านั้น
หากต้องการดึงเกิน 10,000 รายการ ให้ใช้offset_tokenแทน - offsetประเภท: string | null
_token โทเคนออฟเซตสำหรับคำขอถัดไป
ฟิลด์ที่ไม่บังคับ
มีให้ในฟิลด์เดียวกันของการตอบกลับสำหรับแต่ละคำขอ;
ใช้พารามิเตอร์นี้เพื่อหลีกเลี่ยงการหมดเวลาเมื่อพยายามรับผลลัพธ์เกิน 10,000 รายการในคำขอเดียว;
เมื่อระบุค่าoffset_tokenที่ไม่ซ้ำกันจากอาร์เรย์การตอบกลับ คุณจะได้รับผลลัพธ์ถัดไปของงานเริ่มต้น;
ค่าoffset_tokenไม่ซ้ำกันสำหรับแต่ละงานถัดไป
หมายเหตุ: หากระบุoffset_tokenในคำขอ พารามิเตอร์อื่นทั้งหมดยกเว้นlimitจะไม่ถูกนำมาพิจารณาเมื่อประมวลผลงาน
ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์นี้ได้ที่ Help Center - orderประเภท: array string[] | null
_by กฎการเรียงลำดับผลลัพธ์
ฟิลด์ที่ไม่บังคับ
ใช้ค่าเดียวกับในอาร์เรย์filtersเพื่อเรียงลำดับผลลัพธ์ได้
ประเภทการเรียงลำดับที่เป็นไปได้:asc- เรียงผลลัพธ์จากน้อยไปมากdesc- เรียงผลลัพธ์จากมากไปน้อย
ใช้เครื่องหมายจุลภาคเพื่อกำหนดประเภทการเรียงลำดับ
ตัวอย่าง:["keyword_info.competition,desc"]
กฎเริ่มต้น:["keyword_info.search_volume,desc"]
โปรดทราบว่าตั้งกฎการเรียงลำดับได้ไม่เกินสามข้อต่อหนึ่งคำขอ
ใช้เครื่องหมายจุลภาคแยกกฎการเรียงลำดับหลายข้อ
ตัวอย่าง:["keyword_info.search_volume,desc","keyword_info.cpc,desc"] - tagประเภท: string | null
ตัวระบุงานที่ผู้ใช้กำหนด
ฟิลด์ไม่บังคับ
จำกัด 255 อักขระ
ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
คุณจะพบค่าtagที่ระบุในออบเจ็กต์dataของการตอบกลับ
- ประเภท: object | null · Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResponseInfo200
- ประเภท: number | null รูปแบบ: doublecost
ค่าใช้จ่ายรวมของงาน, USD
- ประเภท: integer | nullstatus
_code รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่
- ประเภท: string | nullstatus
_message ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่
- ประเภท: array (object | null)[] | nulltasks
อาร์เรย์ของงาน
- ประเภท: object | null · Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveTaskInfo
- costประเภท: number | null รูปแบบ: double
ค่าใช้จ่ายรวมของงาน, USD
- dataประเภท: object | null
มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST
- propertyประเภท: object | null
Name
- idประเภท: string | null
ตัวระบุงาน ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID
- pathประเภท: array (string | null)[] | null
พาธ URL
- resultประเภท: array (object | null)[] | null
อาร์เรย์ของผลลัพธ์
- itemsประเภท: array (object | null)[] | null
มีคีย์เวิร์ดและข้อมูลที่เกี่ยวข้อง
- avgประเภท: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info ข้อมูลแบ็กลิงก์ของคีย์เวิร์ดที่ส่งคืน
ออบเจ็กต์นี้ให้จำนวนแบ็กลิงก์ หน้าและโดเมนที่อ้างอิงโดยเฉลี่ย รวมถึงค่าอันดับเฉลี่ยในหมู่หน้าเว็บ 10 อันดับแรกที่จัดอันดับแบบออร์แกนิกสำหรับคีย์เวิร์ด- backlinksประเภท: number | null
จำนวนแบ็กลิงก์เฉลี่ย
- dofollowประเภท: number | null
จำนวนลิงก์ dofollow เฉลี่ย
- lastประเภท: string | null
_updated _time วันที่และเวลาที่ข้อมูลคีย์เวิร์ดอัปเดต
ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ตัวอย่าง:2019-11-15 12:57:46 +00:00 - mainประเภท: number | null
_domain _rank - rankประเภท: number | null
- referringประเภท: number | null
_domains จำนวนโดเมนอ้างอิงเฉลี่ย
- referringประเภท: number | null
_main _domains จำนวนโดเมนอ้างอิงหลักเฉลี่ย
- referringประเภท: number | null
_pages จำนวนหน้าอ้างอิงเฉลี่ย
- seประเภท: string | null
_type ประเภทของเครื่องมือค้นหา
- clickstreamประเภท: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info ข้อมูล clickstream ของคีย์เวิร์ดที่ส่งคืน
หากต้องการดึงผลลัพธ์สำหรับฟิลด์นี้ ต้องตั้งค่าพารามิเตอร์include_clickstream_dataเป็นtrue- ageประเภท: object | null
_distribution - propertyประเภท: integer | null รูปแบบ: int64
Name Signed 64-bit integers (long type).
- genderประเภท: object | null
_distribution - propertyประเภท: integer | null รูปแบบ: int64
Name Signed 64-bit integers (long type).
- lastประเภท: string | null
_updated _time วันที่และเวลาที่ข้อมูลคีย์เวิร์ดอัปเดต
ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ตัวอย่าง:2019-11-15 12:57:46 +00:00 - monthlyประเภท: array (object | null)[] | null
_searches จำนวนการค้นหารายเดือน
แสดงจำนวนการค้นหา (โดยประมาณ) สำหรับไอเดียคีย์เวิร์ดนี้ (ตามข้อมูลที่มีในช่วงสิบสองเดือนที่ผ่านมา) ที่กำหนดเป้าหมายไปยังพื้นที่ทางภูมิศาสตร์ที่ระบุ- monthประเภท: integer | null
เดือน
- searchประเภท: integer | null
_volume อัตราปริมาณการค้นหาเฉลี่ยรายเดือน
- yearประเภท: integer | null
ปี
- searchประเภท: integer | null รูปแบบ: int64
_volume อัตราปริมาณการค้นหาเฉลี่ยรายเดือน
แสดงจำนวนการค้นหา (โดยประมาณ) สำหรับไอเดียคีย์เวิร์ดที่กำหนดบน google.com
- keywordประเภท: string | null
ไอเดียคีย์เวิร์ดที่ส่งคืน
- keywordประเภท: object | null · Response36Afe1097B20_KeywordInfo
_info ข้อมูลคีย์เวิร์ดสำหรับไอเดียคีย์เวิร์ดที่ส่งคืน
- categoriesประเภท: array integer[] | null
- competitionประเภท: number | null
การแข่งขัน
แสดงปริมาณการแข่งขันสัมพัทธ์ที่เกี่ยวข้องกับคีย์เวิร์ดที่กำหนด ค่านี้อิงจากข้อมูล Google Ads และอยู่ระหว่าง 0 ถึง 1 (รวมขอบเขต) - competitionประเภท: string | null
_level - cpcประเภท: number | null
ต้นทุนต่อคลิก
แสดงต้นทุนเฉลี่ยต่อคลิก (USD) ที่จ่ายในอดีตสำหรับคีย์เวิร์ด - highประเภท: number | null
_top _of _page _bid ราคาเสนอสูงสุดเพื่อให้โฆษณาแสดงที่ด้านบนของหน้าแรก
ระบุค่าที่สูงกว่าราคาเสนอต่ำสุดประมาณ 80% ที่โฆษณาได้แสดง (อิงสถิติ Google Ads สำหรับผู้ลงโฆษณา)
ค่าอาจแตกต่างกันตามสถานที่ที่ระบุในคำขอ POST - lastประเภท: string | null
_updated _time วันที่และเวลาที่ข้อมูลคีย์เวิร์ดอัปเดต
ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ตัวอย่าง:2019-11-15 12:57:46 +00:00 - lowประเภท: number | null
_top _of _page _bid ราคาเสนอต่ำสุดเพื่อให้โฆษณาแสดงที่ด้านบนของหน้าแรก
ระบุค่าที่สูงกว่าราคาเสนอต่ำสุดประมาณ 20% ที่โฆษณาได้แสดง (อิงสถิติ Google Ads สำหรับผู้ลงโฆษณา)
ค่าอาจแตกต่างกันตามสถานที่ที่ระบุในคำขอ POST - monthlyประเภท: array (object | null)[] | null
_searches จำนวนการค้นหารายเดือน
แสดงจำนวนการค้นหา (โดยประมาณ) สำหรับไอเดียคีย์เวิร์ดนี้ (ตามข้อมูลที่มีในช่วงสิบสองเดือนที่ผ่านมา) ที่กำหนดเป้าหมายไปยังพื้นที่ทางภูมิศาสตร์ที่ระบุ- monthประเภท: integer | null
เดือน
- searchประเภท: integer | null
_volume อัตราปริมาณการค้นหาเฉลี่ยรายเดือน
- yearประเภท: integer | null
ปี
- seประเภท: string | null
_type ประเภทของเครื่องมือค้นหา
- searchประเภท: integer | null รูปแบบ: int64
_volume อัตราปริมาณการค้นหาเฉลี่ยรายเดือน
แสดงจำนวนการค้นหา (โดยประมาณ) สำหรับไอเดียคีย์เวิร์ดที่กำหนดบน google.com - searchประเภท: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend การเปลี่ยนแปลงแนวโน้มปริมาณการค้นหา
แสดงการเปลี่ยนแปลงปริมาณการค้นหาเป็นเปอร์เซ็นต์เมื่อเทียบกับช่วงก่อนหน้า- monthlyประเภท: integer | null
การเปลี่ยนแปลงของปริมาณการค้นหาเป็นเปอร์เซ็นต์เทียบกับเดือนก่อน
- quarterlyประเภท: integer | null
การเปลี่ยนแปลงของปริมาณการค้นหาเป็นเปอร์เซ็นต์เทียบกับไตรมาสก่อน
- yearlyประเภท: integer | null
การเปลี่ยนแปลงของปริมาณการค้นหาเป็นเปอร์เซ็นต์เทียบกับปีก่อน
- keywordประเภท: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing มีปริมาณการค้นหาคีย์เวิร์ดที่ปรับมาตรฐานด้วยปริมาณการค้นหาของ Bing
- isประเภท: boolean | null
_normalized ข้อมูลคีย์เวิร์ดถูกทำให้เป็นมาตรฐาน หากเป็น true ค่าจะถูกทำให้เป็นมาตรฐานด้วยข้อมูล Bing
- lastประเภท: string | null
_updated _time วันที่และเวลาที่ชุดข้อมูลได้รับการอัปเดต ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00” ตัวอย่าง: 2019-11-15 12:57:46 +00:00
- monthlyประเภท: array (object | null)[] | null
_searches อัตราปริมาณการค้นหารายเดือน อาร์เรย์ของออบเจกต์ที่มีอัตราปริมาณการค้นหาในเดือนใดเดือนหนึ่งของปี
- monthประเภท: integer | null
เดือน
- searchประเภท: integer | null
_volume อัตราปริมาณการค้นหาเฉลี่ยรายเดือน
- yearประเภท: integer | null
ปี
- searchประเภท: integer | null
_volume อัตราปริมาณการค้นหาปัจจุบันของคีย์เวิร์ด
- keywordประเภท: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream มีปริมาณการค้นหาคีย์เวิร์ดที่ปรับมาตรฐานด้วยข้อมูล clickstream
- isประเภท: boolean | null
_normalized ข้อมูลคีย์เวิร์ดถูกทำให้เป็นมาตรฐาน หากเป็น true ค่าจะถูกทำให้เป็นมาตรฐานด้วยข้อมูล Bing
- lastประเภท: string | null
_updated _time วันที่และเวลาที่ชุดข้อมูลได้รับการอัปเดต ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00” ตัวอย่าง: 2019-11-15 12:57:46 +00:00
- monthlyประเภท: array (object | null)[] | null
_searches อัตราปริมาณการค้นหารายเดือน อาร์เรย์ของออบเจกต์ที่มีอัตราปริมาณการค้นหาในเดือนใดเดือนหนึ่งของปี
- monthประเภท: integer | null
เดือน
- searchประเภท: integer | null
_volume อัตราปริมาณการค้นหาเฉลี่ยรายเดือน
- yearประเภท: integer | null
ปี
- searchประเภท: integer | null
_volume อัตราปริมาณการค้นหาปัจจุบันของคีย์เวิร์ด
- keywordประเภท: object | null · Response36Afe1097B20_KeywordProperties
_properties ข้อมูลเพิ่มเติมเกี่ยวกับคีย์เวิร์ด
- coreประเภท: string | null
_keyword คีย์เวิร์ดหลักในกลุ่ม
มีคีย์เวิร์ดหลักในกลุ่มที่กำหนดโดยอัลกอริทึมการจัดกลุ่มคำพ้องความหมาย
หากค่าเป็นnullฐานข้อมูลของเราไม่มีคีย์เวิร์ดใดที่อัลกอริทึมที่เกี่ยวข้องสามารถระบุได้ว่ามีความหมายเหมือนกับkeyword - detectedประเภท: string | null
_language ภาษาที่ตรวจพบของคีย์เวิร์ด
ระบุภาษาของคีย์เวิร์ดตามที่ระบบของเราตรวจพบ - isประเภท: boolean | null
_another _language ภาษาที่ตรวจพบของคีย์เวิร์ดแตกต่างจากภาษาที่ตั้งไว้
หากเป็นtrueภาษาที่ตั้งไว้ในคำขอไม่ตรงกับภาษาที่ระบบของเรากำหนดสำหรับคีย์เวิร์ดที่กำหนด - keywordประเภท: integer | null
_difficulty ความยากในการจัดอันดับในผลลัพธ์ออร์แกนิก 10 อันดับแรกสำหรับคีย์เวิร์ด
ระบุโอกาสในการติด 10 อันดับแรกของผลลัพธ์ออร์แกนิกสำหรับคีย์เวิร์ดบนสเกลลอการิทึมตั้งแต่ 0 ถึง 100;
คำนวณโดยวิเคราะห์โปรไฟล์ลิงก์ของ 10 หน้าแรกใน SERP ร่วมกับพารามิเตอร์อื่น ๆ;
อ่านเพิ่มเติมเกี่ยวกับตัวชี้วัดได้ในคู่มือศูนย์ช่วยเหลือนี้ - seประเภท: string | null
_type ประเภทของเครื่องมือค้นหา
- synonymประเภท: string | null
_clustering _algorithm อัลกอริทึมที่ใช้ระบุคำพ้องความหมาย
ค่าที่เป็นไปได้:keyword_metrics- ระบุอัลกอริทึมที่อิงพารามิเตอร์keyword_infotext_processing- ระบุอัลกอริทึมแบบข้อความ
หากค่าเป็นnullฐานข้อมูลของเราไม่มีคีย์เวิร์ดใดที่อัลกอริทึมที่เกี่ยวข้องสามารถระบุได้ว่ามีความหมายเหมือนกับkeyword - wordsประเภท: integer | null รูปแบบ: int64
_count จำนวนคำในคีย์เวิร์ด
ระบุจำนวนคำที่คีย์เวิร์ดประกอบด้วย
- languageประเภท: string | null
_code รหัสภาษาในอาร์เรย์ POST
- locationประเภท: integer | null
_code รหัสสถานที่ในอาร์เรย์ POST
- seประเภท: string | null
_type ประเภทของเครื่องมือค้นหา
- searchประเภท: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignประเภท: array (string | null)[] | null
_intent เจตนาการค้นหาเสริม
ค่าที่เป็นไปได้:informational,navigational,commercial,transactional - lastประเภท: string | null
_updated _time วันที่และเวลาที่ข้อมูลคีย์เวิร์ดอัปเดต
ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ตัวอย่าง:2019-11-15 12:57:46 +00:00 - mainประเภท: string | null
_intent เจตนาการค้นหาหลัก
ค่าที่เป็นไปได้:informational,navigational,commercial,transactional - seประเภท: string | null
_type ประเภทของเครื่องมือค้นหา
- serpประเภท: object | null · Response36Afe1097B20_SerpInfo
_info ข้อมูล SERP
ค่าจะเป็นnullหากคุณไม่ได้ตั้งค่าฟิลด์include_serp_infoเป็นtrueในอาร์เรย์ POST หรือไม่มีข้อมูล SERP สำหรับคีย์เวิร์ดนี้ในฐานข้อมูลของเรา- checkประเภท: string | null
_url URL โดยตรงไปยังผลลัพธ์ของเครื่องมือค้นหา
คุณใช้ URL นี้เพื่อตรวจสอบว่าเราให้ผลลัพธ์ที่แม่นยำ - lastประเภท: string | null
_updated _time วันที่และเวลาที่ข้อมูลคีย์เวิร์ดอัปเดต
ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ตัวอย่าง:2019-11-15 12:57:46 +00:00 - previousประเภท: string | null
_updated _time วันที่และเวลาก่อนหน้าครั้งล่าสุดที่ข้อมูล SERP อัปเดต
ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ตัวอย่าง:2019-10-15 12:57:46 +00:00 - seประเภท: integer | null รูปแบบ: int64
_results _count จำนวนผลการค้นหาสำหรับคีย์เวิร์ดที่ส่งคืน
- seประเภท: string | null
_type ประเภทของเครื่องมือค้นหา
- serpประเภท: array (string | null)[] | null
_item _types ประเภทของผลการค้นหาใน SERP
มีประเภทของผลการค้นหา (items) ที่พบใน SERP
ประเภทรายการที่เป็นไปได้:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
หมายเหตุ ผลลัพธ์จริงจะถูกส่งคืนเฉพาะสำหรับองค์ประกอบorganic,paid,featured_snippetและlocal_packเท่านั้น
- itemsประเภท: integer | null รูปแบบ: int64
_count จำนวนผลลัพธ์ที่ส่งคืนในอาร์เรย์
items - languageประเภท: string | null
_code รหัสภาษาในอาร์เรย์ POST
- locationประเภท: integer | null
_code รหัสสถานที่ในอาร์เรย์ POST
- offsetประเภท: integer | null
ค่า offset ปัจจุบัน
- offsetประเภท: string | null
_token โทเคนออฟเซ็ตสำหรับคำขอถัดไป
คุณสามารถใช้สตริงที่ให้ไว้ในฟิลด์นี้เพื่อรับผลลัพธ์ถัดไปของงานเริ่มต้น;
หมายเหตุ: ค่าoffset_tokenไม่ซ้ำกันสำหรับแต่ละงานถัดไป - seประเภท: string | null
_type ประเภทของเครื่องมือค้นหา
- totalประเภท: integer | null รูปแบบ: int64
_count จำนวนผลลัพธ์ทั้งหมดในฐานข้อมูลของเราที่เกี่ยวข้องกับคำขอของคุณ
- 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/dataforseo_labs/google/top_searches/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_name": "English",
"location_code": 2840,
"limit": 3
}
]'
{
"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": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}