Google Autocomplete Advanced แบบเรียลไทม์

Felo API Support

MIT

เซิร์ฟเวอร์

https://openapi.felo.ai

ไลบรารีไคลเอนต์

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO การดำเนินการ

post/v1/beta/dataforseo/serp/google/autocomplete/live/advanced

Google Autocomplete Advanced แบบเรียลไทม์

คืนค่าข้อเสนอแนะที่ Google แสดงเมื่อพิมพ์คำค้นบน Google แบบซิงโครนัส คืนค่า keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count และ items advanced เป็นค่าเริ่มต้น ใช้ regular เมื่อสนใจเฉพาะรายการที่จัดอันดับแล้ว และใช้ html เฉพาะเมื่อต้องการตรวจสอบว่าตัวแยกวิเคราะห์ตัดอะไรทิ้งไป ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200

ข้อมูลอ้างอิงราคา

การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
ค่าประมาณคำขออ้างอิง: USD 0.02
ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้

application/json

ประเภท: array (object | null)[]
- client
  ประเภท: string | null
  
  ไคลเอนต์ค้นหาสำหรับ autocomplete
  
  ฟิลด์ที่ไม่บังคับ
  
  ผลลัพธ์ autocomplete อาจแตกต่างกันไปตามไคลเอนต์ค้นหา;
  
  ค่าที่เป็นไปได้:
  
  chrome — ใช้เมื่อเปิด Google Search ในเบราว์เซอร์ Google Chrome;
  
  chrome-omni — ใช้ในแถบที่อยู่ของ Chrome;
  
  gws-wiz — ใช้ในหน้าแรกของ Google Search;
  
  gws-wiz-serp — ใช้ในหน้าผลลัพธ์ของเสิร์ชเอนจิน Google;
  
  safari — ใช้เมื่อเปิด Google Search ในเบราว์เซอร์ Safari;
  
  firefox — ใช้เมื่อเปิด Google Search ในเบราว์เซอร์ Firefox;
  
  psy-ab — อาจใช้เมื่อเปิด Google Search ในเบราว์เซอร์ Google Chrome;
  
  toolbar — คืนค่า XML;
  
  youtube — คืนค่า JSONP;
  
  gws-wiz-local — ใช้ใน Google Local;
  
  img — ใช้ในการค้นหารูปภาพของ Google;
  
  products-cc — ใช้ในการค้นหาสินค้าของ Google
- cursor_pointer
  ประเภท: integer | null
  
  ตัวชี้เคอร์เซอร์ในแถบค้นหา
  
  ฟิลด์ที่ไม่บังคับ
  
  ตำแหน่งตัวเลขแนวนอนของตัวชี้เคอร์เซอร์ภายในคีย์เวิร์ดในแถบค้นหา;
  
  การเปลี่ยนตำแหน่งตัวชี้เคอร์เซอร์จะทำให้ได้คำแนะนำ autocomplete ที่แตกต่างกันสำหรับคีย์เวิร์ดตั้งต้นเดียวกัน;
  
  ค่าต่ำสุด: 0
  
  ค่าเริ่มต้น: หมายเลขของอักขระตัวสุดท้ายของ keyword ที่ระบุ
  
  ตัวอย่าง:
  
  |which query are s - "cursor_pointer": 0
  
  which query is s| - "cursor_pointer": 16
  
  which que|ry is s - "cursor_pointer": 9
- keyword
  ประเภท: string
  
  คีย์เวิร์ด
  
  ฟิลด์ที่จำเป็น
  
  ระบุได้สูงสุด 700 อักขระในฟิลด์ keyword
  
  %## ทั้งหมดจะถูกถอดรหัส (อักขระ ‘+’ จะถูกถอดรหัสเป็นอักขระเว้นวรรค)
  
  หากต้องการใช้ อักขระ “%” ใน keyword ให้ระบุเป็น “%25”;
  
  หากต้องการใช้ อักขระ “+” ใน keyword ให้ระบุเป็น “%2B”;
  
  ดูรายละเอียดกฎและข้อจำกัดของฟิลด์ keyword และ keywords ใน DataForSEO API ได้ในบทความ Help Center
- language_code
  ประเภท: string
  
  รหัสภาษาของเครื่องมือค้นหา
  
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ language_name
  
  หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ language_name;
  
  คุณสามารถรับรายการภาษาของเครื่องมือค้นหาที่ใช้ได้พร้อม language_code ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/serp/google/languages
  
  ตัวอย่าง:
  
  en
- language_name
  ประเภท: string
  
  ชื่อเต็มของภาษาของเครื่องมือค้นหา
  
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ language_code
  
  หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ language_code;
  
  คุณสามารถรับรายการภาษาของเครื่องมือค้นหาที่ใช้ได้พร้อม language_name ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/serp/google/languages
  
  ตัวอย่าง:
  
  English
- location_code
  ประเภท: integer
  
  รหัสสถานที่ของเครื่องมือค้นหา
  
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ location_name;
  
  คุณสามารถรับรายการสถานที่ของเครื่องมือค้นหาที่ใช้ได้พร้อม location_code ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/serp/google/locations
  
  ตัวอย่าง:
  
  2840
- location_name
  ประเภท: string
  
  ชื่อเต็มของสถานที่ของเครื่องมือค้นหา
  
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ location_code
  
  หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ location_code;
  
  คุณสามารถรับรายการสถานที่ของเครื่องมือค้นหาที่ใช้ได้พร้อม location_name ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/serp/google/autocomplete/locations
  
  ตัวอย่าง:
  
  London,England,United Kingdom
- tag
  ประเภท: string | null
  
  ตัวระบุงานที่ผู้ใช้กำหนด
  
  ฟิลด์ที่ไม่บังคับ
  
  จำกัดอักขระ 255 ตัว
  
  คุณสามารถใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
  
  คุณจะพบค่า tag ที่ระบุในออบเจกต์ data ของการตอบกลับ

การตอบกลับ

200
ประเภท: object | null · Response36Afe1097B20_SerpGoogleAutocompleteLiveAdvancedResponseInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

status_code
ประเภท: integer | null

รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

tasks
ประเภท: array (object | null)[] | null

อาร์เรย์ของงาน

ประเภท: object | null · Response36Afe1097B20_SerpGoogleAutocompleteLiveAdvancedTaskInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

data
ประเภท: object | null

มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST

propertyName
ประเภท: object | null
id
ประเภท: string | null

ตัวระบุงาน ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID

path
ประเภท: array (string | null)[] | null

พาธ URL

result
ประเภท: array (object | null)[] | null

อาร์เรย์ของผลลัพธ์

check_url
ประเภท: string | null

URL โดยตรงไปยังผลลัพธ์ของเครื่องมือค้นหา
คุณใช้ URL นี้เพื่อตรวจสอบว่าเราให้ผลลัพธ์ที่แม่นยำ

datetime
ประเภท: string | null

วันที่และเวลาที่ได้รับผลลัพธ์
ในรูปแบบ UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ตัวอย่าง:
2019-11-15 12:57:46 +00:00

item_types
ประเภท: array (string | null)[] | null

ประเภทของผลการค้นหาใน SERP
มีประเภทของผลการค้นหา (items) ที่พบใน SERP
ประเภทรายการที่เป็นไปได้:
autocomplete

items
ประเภท: array (object | null)[] | null

รายการขององค์ประกอบ

highlighted
ประเภท: array (string | null)[] | null

คีย์เวิร์ดที่ไฮไลต์ใน autocomplete
มีรายการคำแนะนำ google autocomplete ที่ไฮไลต์ในแถบค้นหา;
หมายเหตุ: อาร์เรย์นี้ใช้ได้เฉพาะกับ client ต่อไปนี้:
gws-wiz
psy-ab
gws-wiz-local

rank_absolute
ประเภท: integer | null

อันดับสัมบูรณ์ใน SERP
ตำแหน่งสัมบูรณ์เทียบกับองค์ประกอบทั้งหมดใน SERP

rank_group
ประเภท: integer | null

อันดับกลุ่มใน SERP
ตำแหน่งภายในกลุ่มขององค์ประกอบที่มีค่า type เหมือนกัน
ตำแหน่งขององค์ประกอบที่มีค่า type ต่างกันจะไม่รวมอยู่ใน rank_group

relevance
ประเภท: integer | null

ความเกี่ยวข้องของคีย์เวิร์ดที่แนะนำ
แสดงความเกี่ยวข้องของคำแนะนำ autocomplete กับคีย์เวิร์ดเป้าหมาย
รับค่าตั้งแต่ 500 ถึง 2000
ยิ่งค่าสูง คำแนะนำยิ่งเกี่ยวข้อง
หมายเหตุ: ใช้ได้เฉพาะกับ client ต่อไปนี้:
chrome/chrome-omni

search_query_url
ประเภท: string | null

url ไปยังผลการค้นหา
url ไปยังผลการค้นหาที่เกี่ยวข้องกับคำแนะนำ google autocomplete

suggestion
ประเภท: string | null

คำแนะนำคีย์เวิร์ดจาก google autocomplete

suggestion_type
ประเภท: string | null

ประเภทคำแนะนำ google autocomplete
หมายเหตุ: ใช้ได้เฉพาะกับ client ต่อไปนี้:
chrome/chrome-omni

thumbnail_url
ประเภท: string | null

url ของรูปภาพขนาดย่อ
url ของรูปภาพขนาดย่อของคำแนะนำ google autocomplete
หมายเหตุ: ใช้ได้เฉพาะกับ client ต่อไปนี้:
gws-wiz
gws-wiz-serp

type
ประเภท: string | null

ประเภทขององค์ประกอบ

items_count
ประเภท: integer | null รูปแบบ: int64

จำนวนผลลัพธ์ที่คืนค่าในอาร์เรย์ items

keyword
ประเภท: string | null

คีย์เวิร์ดที่ได้รับในอาร์เรย์ POST
คีย์เวิร์ดจะถูกส่งกลับโดยถอดรหัส %## แล้ว (อักขระ '+' จะถูกถอดรหัสเป็นช่องว่าง)

language_code
ประเภท: string | null

รหัสภาษาในอาร์เรย์ POST

location_code
ประเภท: integer | null

รหัสสถานที่ในอาร์เรย์ POST

refinement_chips
ประเภท: object | null · Response36Afe1097B20_RefinementChipsInfo

ชิปการปรับแต่งการค้นหา

items
ประเภท: array (object | null)[] | null

รายการขององค์ประกอบ

domain
ประเภท: string | null

โดเมนใน SERP

options
ประเภท: array (object | null)[] | null

ตัวเลือกการปรับแต่งการค้นหาเพิ่มเติม

domain
ประเภท: string | null

โดเมนใน SERP

title
ประเภท: string | null

ชื่อเรื่องขององค์ประกอบ

type
ประเภท: string | null

ประเภทขององค์ประกอบ

url
ประเภท: string | null

URL การค้นหาพร้อมพารามิเตอร์การกรอง

title
ประเภท: string | null

ชื่อเรื่องขององค์ประกอบ

type
ประเภท: string | null

ประเภทขององค์ประกอบ

url
ประเภท: string | null

URL การค้นหาพร้อมพารามิเตอร์การกรอง

type
ประเภท: string | null

ประเภทขององค์ประกอบ

xpath
ประเภท: string | null

XPath ขององค์ประกอบ

se_domain
ประเภท: string | null

โดเมนของเครื่องมือค้นหาในอาร์เรย์ POST

se_results_count
ประเภท: integer | null รูปแบบ: int64

จำนวนผลลัพธ์ทั้งหมดใน SERP

spell
ประเภท: object | null · Response36Afe1097B20_SpellInfo

การแก้ไขอัตโนมัติของเครื่องมือค้นหา
หากเครื่องมือค้นหาให้ผลลัพธ์สำหรับคีย์เวิร์ดที่ถูกแก้ไข เราจะระบุคีย์เวิร์ดที่เครื่องมือค้นหาแก้ไขและประเภทของการแก้ไขอัตโนมัติ;
ในกรณีนี้ จะเท่ากับ null

keyword
ประเภท: string | null

คีย์เวิร์ดที่ได้จากการแก้ไขคำอัตโนมัติของเครื่องมือค้นหา ผลลัพธ์จะถูกจัดหาให้สำหรับคีย์เวิร์ดที่แก้ไขแล้ว

type
ประเภท: string | null

ประเภทของการแก้ไขอัตโนมัติ ค่าที่เป็นไปได้: did_you_mean, showing_results_for, no_results_found_for, including_results_for หมายเหตุ: Yahoo และ Yandex รองรับเฉพาะประเภทการแก้ไขอัตโนมัติต่อไปนี้: including_results_for

type
ประเภท: string | null

ประเภทขององค์ประกอบ

result_count
ประเภท: integer | null รูปแบบ: int64

จำนวนองค์ประกอบในอาร์เรย์ result

status_code
ประเภท: integer | null

รหัสสถานะของงาน สร้างโดย DataForSEO โดยอยู่ในช่วงต่อไปนี้ได้: 10000-60000 คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลของงาน คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

time
ประเภท: string | null

เวลาดำเนินการ, วินาที

tasks_count
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks

tasks_error
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด

time
ประเภท: string | null

เวลาดำเนินการทั้งหมด (วินาที)

version
ประเภท: string | null

เวอร์ชันปัจจุบันของ API
application/json
400

ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ
401

จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
402

ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน
403

บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้
429

ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว
502

บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้
503

API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว
504

บริการหมดเวลาระหว่างประมวลผลคำขอ
default

การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

application/json

post/v1/beta/dataforseo/serp/google/autocomplete/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/autocomplete/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "client": "gws-wiz-serp"
  }
]'

แสดงสคีมา

{
  "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,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "relevance": null,
              "suggestion": null,
              "suggestion_type": null,
              "search_query_url": null,
              "thumbnail_url": null,
              "highlighted": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

ดำเนินการสำเร็จ

Google Autocomplete Advanced แบบเรียลไทม์

การยืนยันตัวตนRequired

DataForSEO

Google Autocomplete Advanced แบบเรียลไทม์

ข้อมูลอ้างอิงราคา