BytePlus
Web search and page content retrieval.
การค้นหาเว็บแบบเรียลไทม์สำหรับ AI
รันการค้นหาเว็บแบบเรียลไทม์ที่สร้างมาเพื่อเอเจนต์ AI และคืนรายการผลลัพธ์ที่จัดอันดับแล้วพร้อมชื่อเรื่อง ลิงก์ และสแนปเปต Query เป็นฟิลด์บังคับ; จำกัดชุดผลลัพธ์ด้วย Count (≤ 20), Filter (จำกัดเฉพาะ Sites หรือยกเว้น BlockHosts), Language และ TimeRange การตอบกลับห่อ ResponseMetadata.RequestId และรายการ Result ของผลการค้นหาเว็บ ใช้สำหรับการเสริมการดึงข้อมูลแบบ RAG การติดตามคู่แข่งและ PR การตรวจสอบข้อเท็จจริง และการหาแหล่งเนื้อหา จับคู่ URL ของแต่ละผลลัพธ์กับ post_byteplus_fetch เพื่อดึงเนื้อหาหน้าฉบับเต็ม
ข้อมูลอ้างอิงราคา
- การวัดปริมาณการใช้งาน: คิดตามต้นทุนคงที่ต่อคำขอที่สำเร็จ
- ค่าประมาณคำขออ้างอิง: USD 0.0048
- ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว
เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo
- ประเภท: stringQueryความยาวสูงสุด:400จำเป็น
คำค้น เป็นฟิลด์บังคับ สูงสุด 400 อักขระ เอนจินต้นทางยังจำกัดความยาวได้จริงที่ประมาณ 50 คำ
- ประเภท: integerCountสูงสุด:20
จำนวนผลลัพธ์ที่จะคืน ไม่บังคับ ค่าเริ่มต้น 10 สูงสุด 20
- ประเภท: objectFilter
ตัวกรองผลลัพธ์แบบไม่บังคับ ทั้งสองฟิลด์เป็นสตริงโดเมนเต็มที่คั่นด้วยเครื่องหมายท่อ (สูงสุด 5 รายการต่อฟิลด์)
- Blockประเภท: string
Hosts ตัดผลลัพธ์จากโดเมนเต็มเหล่านี้ คั่นด้วยเครื่องหมายท่อ สูงสุด 5 เช่น "reddit.com|quora.com"
- Sitesประเภท: string
จำกัดผลลัพธ์ให้เฉพาะโดเมนเต็มเหล่านี้ คั่นด้วยเครื่องหมายท่อ สูงสุด 5 เช่น "bytedance.com|byteplus.com" (การส่งอาร์เรย์จะคืน 10400 Invalid Parameter)
- ประเภท: stringLanguage
คำใบ้ภาษาตามรูปแบบต้นทาง (ไม่บังคับ) เช่น EN, ZH-HANS, ZH-HANT
- Time
Range ช่วงเวลาล่าสุดแบบไม่บังคับ ใช้หนึ่งในค่าที่กำหนด OneDay / OneWeek / OneMonth / OneYear หรือช่วงกำหนดเอง "YYYY-MM-DD..YYYY-MM-DD" ละเว้นหากไม่ต้องการกรองตามเวลา หมายเหตุ: ค่าเช่น "week"/"month" จะถูกเพิกเฉยโดยไม่แจ้งที่ต้นทาง
- ประเภท: string enum
ช่วงเวลาล่าสุดแบบไม่บังคับ ใช้หนึ่งในค่าที่กำหนด OneDay / OneWeek / OneMonth / OneYear หรือช่วงกำหนดเอง "YYYY-MM-DD..YYYY-MM-DD" ละเว้นหากไม่ต้องการกรองตามเวลา หมายเหตุ: ค่าเช่น "week"/"month" จะถูกเพิกเฉยโดยไม่แจ้งที่ต้นทาง
ค่า- One
Day - One
Week - One
Month - One
Year
- ประเภท: object200
ค้นหาสำเร็จ
Resultมีผลการค้นหาเว็บที่จัดอันดับแล้ว- ประเภท: objectResponse
Metadata ข้อมูลเมตาของคำขอต้นทาง
- Actionประเภท: string
- Regionประเภท: string
- Requestประเภท: string
Id ตัวระบุเฉพาะของคำขอนี้
- Serviceประเภท: string
- Versionประเภท: string
- ประเภท: objectResult
เพย์โหลดผลการค้นหา
- Choicesประเภท: array object[] | null
สงวนไว้; เป็น null เว้นแต่จะเกี่ยวข้อง
ออบเจ็กต์ว่าง - Logประเภท: string
Id id บันทึกของต้นทาง (เท่ากับ ResponseMetadata.RequestId)
- Resultประเภท: integer
Count จำนวนผลลัพธ์เว็บที่คืน
- Searchประเภท: object
Context การสะท้อนบริบทคำค้นที่แปลงแล้ว
- Originประเภท: string
Query - Searchประเภท: string
Type
- Timeประเภท: integer
Cost เวลาประมวลผลของต้นทางเป็นมิลลิวินาที
- Usageประเภท: object | null
สงวนไว้; เป็น null เว้นแต่จะเกี่ยวข้อง
- Webประเภท: array object[]
Results รายการผลลัพธ์เว็บที่จัดอันดับแล้ว
- Idประเภท: string
id ผลลัพธ์แบบทึบ
- Logoประเภท: string
Url URL โลโก้ไซต์ที่ลงลายเซ็นแล้ว (มีอายุจำกัด)
- Publishประเภท: string
Time เวลาเผยแพร่ในรูปแบบ ISO 8601 (อาจว่างเปล่า)
- Publishประเภท: integer
Time Unix เวลาเผยแพร่เป็นวินาที Unix (0 หากไม่ทราบ)
- Siteประเภท: string
Name ชื่อไซต์ต้นทาง (อาจว่างเปล่า)
- Snippetประเภท: string
สแนปเปตข้อความสั้นจากหน้า
- Sortประเภท: integer
Id อันดับของผลลัพธ์โดยเริ่มที่ 1
- Summaryประเภท: string
บทสรุปที่ยาวขึ้นของเนื้อหาหน้า
- Titleประเภท: string
ชื่อเรื่องผลลัพธ์
- Urlประเภท: string
URL ผลลัพธ์
application/json - 400
ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ
- 401
จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
- 402
ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน
- 403
บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้
- 429
ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว
- 502
บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้
- 503
API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว
- 504
บริการหมดเวลาระหว่างประมวลผลคำขอ
- default
การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ
application/json
curl https://openapi.felo.ai/v1/beta/byteplus/web-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"Query": "OpenAI news"
}'
{
"ResponseMetadata": {
"RequestId": "20260904155503A787EC832774768DC56F",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"ResultCount": 3,
"WebResults": [
{
"Id": "19b903d59c017bbb04c7832574500d49",
"SortId": 1,
"Title": "OpenAI News | OpenAI",
"SiteName": "OpenAI",
"Url": "https://openai.com/news/",
"Snippet": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"Summary": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"PublishTime": "2026-09-03T07:50:20+08:00",
"PublishTimeUnix": 1788393020,
"LogoUrl": "https://p16-bpsearch-sign.ibyteimg.com/...<signed>"
}
],
"SearchContext": {
"OriginQuery": "OpenAI latest news",
"SearchType": "web"
},
"TimeCost": 935,
"LogId": "20260904155503A787EC832774768DC56F",
"Choices": null,
"Usage": null
}
}