# ค้นหาเว็บด้วย Felo

POST /api/v1/data/web/search

ค้นหาเว็บและรับหน้าแหล่งข้อมูลเพื่อให้แอปพลิเคชันของคุณประมวลผล หากต้องการคำตอบที่สร้างขึ้นพร้อมแหล่งข้อมูล ให้ใช้ [Chat](https://openapi.felo.ai/th/docs/data-api/guides/felo-chat.md)

ตัวอย่างทั้งหมดใช้ `FELO_API_KEY` จาก [ภาพรวม](https://openapi.felo.ai/th/docs/data-api/guides/felo-overview.md) การเรียกใช้ใช้ **ยอดคงเหลือบนแพลตฟอร์ม** ไม่ใช่ Felo Pro credits ตัวอย่างการตอบกลับมีไว้เพื่อประกอบการอธิบาย; เนื้อหาจริงและฟิลด์เสริมอาจแตกต่างกัน

## เอนด์พอยต์

`POST /api/v1/data/web/search`

## คำขอ

| ฟิลด์ | ประเภท | จำเป็น | ความหมาย |
|---|---|---|---|
| `query` | string | ใช่ | คำค้นหา, 1–4,000 อักขระ |
| `count` | integer | ไม่ | จำนวนผลลัพธ์ที่ร้องขอ, 1–50; ค่าเริ่มต้น 10 |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"retrieval augmented generation","count":3}'
```

## การตอบกลับ

HTTP 200 ส่งคืนผลลัพธ์ที่ราก JSON:

```json
{
  "resources": [
    {"title":"Example guide","link":"https://example.com/guide","snippet":"An introduction to retrieval augmented generation."}
  ],
  "total": 1
}
```

| ฟิลด์ | ความหมาย |
|---|---|
| `resources` | หน้าเพจที่ส่งคืน; แต่ละรายการมี `title`, `link` และ `snippet` |
| `total` | จำนวนทรัพยากรที่ส่งคืน ไม่ใช่จำนวนหน้าเว็บทั้งหมดบนอินเทอร์เน็ต |

`count` คือจำนวนที่ร้องขอ ไม่ใช่การรับประกันว่าจะมีผลลัพธ์ที่ตรงกันเพียงพอ เอนด์พอยต์นี้ไม่มีพารามิเตอร์ cursor หากต้องการอ่านแหล่งข้อมูลแบบเต็ม ให้ส่ง `link` ของมันไปที่ [Web Read](https://openapi.felo.ai/th/docs/data-api/guides/felo-web-read.md)

## การเรียกเก็บเงินและความล้มเหลว

หน่วยการเรียกเก็บเงินคือหนึ่งคำขอ (`web.search`) ไม่ใช่หนึ่งหน้าที่ส่งคืน อ่าน [ราคาปัจจุบัน](https://openapi.felo.ai/api/v1/data/prices) ความผิดพลาดด้านยอดคงเหลือหรือโควต้าต้องจัดการแยกจากผลลัพธ์ว่างที่สำเร็จ; ดู [Billing and Errors](https://openapi.felo.ai/th/docs/data-api/guides/felo-billing.md)