# Web search API quick start: ค้นหาครั้งแรกของคุณในสองนาที

> Web search API quick start: รับ API key เรียกค้นหาครั้งแรกด้วย curl, Python หรือ Node.js และอ่านหน้าเว็บชั้นนำเป็น Markdown ไม่ต้อง KYC จ่ายด้วยคริปโต

- URL: https://llmwebsearch.com/th/docs/
- อัปเดตล่าสุด: 2026-10-22
- ผู้เผยแพร่: LLMWebSearch (https://llmwebsearch.com)

endpoint เดียวทำงานทั้งหมด: ส่งคำถามไปที่ `/search` แล้วรับผลลัพธ์ที่จัดอันดับกลับมา พร้อมหน้าเว็บแรก ๆ ที่อ่านและทำความสะอาดเป็น Markdown แล้ว หน้านี้พาคุณจากยอดคงเหลือว่างเปล่าไปจนถึงการเรียกที่ใช้งานได้ แล้วชี้ไปยังทุกหน้าของเอกสาร

**คำตอบสั้น — จะรันการค้นหาครั้งแรกด้วย web search API สำหรับ AI agents ได้อย่างไร?**

ส่งคำถามของคุณไปที่ `POST https://llmwebsearch.com/api/v1/search` พร้อม API key เป็น Bearer token **LLMWebSearch** รันการค้นหาเว็บแบบสดและคืนผลลัพธ์ที่จัดอันดับสูงสุด 20 รายการ พร้อมอ่าน 3 หน้าแรกและส่งกลับเป็น Markdown หนึ่งเครดิตจ่ายให้การเรียกทั้งหมดนั้น เริ่มที่ US$1.20/1K การค้นหา ตั้งแต่ตุลาคม 2026 ไม่ต้อง KYC จ่ายด้วยคริปโต

## API ในบัตรเดียว

| คุณลักษณะ | ค่า |
| --- | --- |
| Base URL | `https://llmwebsearch.com/api/v1` |
| ค้นหา | `POST` หรือ `GET https://llmwebsearch.com/api/v1/search` |
| อ่าน URL ที่คุณมีอยู่แล้ว | `POST https://llmwebsearch.com/api/v1/extract` |
| เครดิตคงเหลือ | `GET https://llmwebsearch.com/api/v1/credits` ฟรี ไม่มีค่าใช้จ่าย |
| การยืนยันตัวตน | ส่ง API key ของคุณเป็น Bearer token ใน header Authorization หรือเป็น query parameter api_key |
| การเรียกเก็บเงิน | หนึ่งเครดิตจ่ายสำหรับการค้นหาหนึ่งครั้ง: ผลลัพธ์แบบจัดอันดับสูงสุด 20 รายการ โดยอ่านหน้าเว็บของ 3 รายการแรกและส่งกลับเป็น Markdown การอ่าน 4 ถึง 10 หน้าใช้ 2 เครดิต การเรียกที่จบลงด้วยข้อผิดพลาดไม่มีค่าใช้จ่าย |
| page reader ของเรา | `LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/)`, robots.txt token `LLMWebSearch` |
| แพ็กเกจเล็กที่สุด | 5,000 การค้นหา สำหรับ US$9.25; เครดิตไม่มีวันหมดอายุ |

## ฉันจะขอ API key ได้อย่างไร?

ไม่มีแบบฟอร์มสมัคร สิ่งที่ใช้เวลานานที่สุดคือการรอให้ blockchain ยืนยันการเติมเงินของคุณ

1. **เติมยอดคงเหลือด้วยคริปโต** — ส่งอย่างน้อย US$25 ใน BTC, USDT, USDC, ETH, SOL, LTC ลงชื่อเข้าใช้ด้วยหมายเลขบัญชี; อีเมลเป็นทางเลือก
2. **ซื้อแพ็กเกจการค้นหา** — 5,000 การค้นหา สำหรับ US$9.25 เพียงพอที่จะเชื่อมต่อการค้นหาเข้ากับเอเจนต์ตัวหนึ่งและลองทุกตัวเลือก
3. **คัดลอกคีย์** — เมื่อการเติมเงินด้วยคริปโตของคุณได้รับการยืนยันและซื้อแพ็กแล้ว API key ของคุณรออยู่ในแดชบอร์ด เก็บไว้ใน environment variable ชื่อ LLMWEBSEARCH_API_KEY

## การค้นหาครั้งแรกมีหน้าตาอย่างไร?

เป็น HTTPS POST เพียงครั้งเดียว พร้อม JSON body ขนาดเล็ก จำเป็นต้องมีเพียง `q` เท่านั้น คือคำถามหรือคำค้นหา ที่พิมพ์เหมือนที่คนทั่วไปพิมพ์ ค่าเริ่มต้นเหมาะกับเอเจนต์ส่วนใหญ่อยู่แล้ว คุณจะได้ผลลัพธ์จัดอันดับ 5 รายการ และหน้าเว็บที่อยู่เบื้องหลัง 3 รายการแรกจะถูกอ่านและส่งกลับเป็น Markdown ยาวสูงสุด 6,000 ตัวอักษรต่อหน้า

โค้ดสามตัวอย่างด้านล่างส่งการค้นหาเดียวกัน เลือกอันที่ตรงกับสแต็กของคุณ ตั้งค่า `LLMWEBSEARCH_API_KEY` ใน shell แล้วรัน

*curl: ค้นหาหนึ่งครั้ง อ่าน 3 หน้าแรก*

```bash
curl -s "https://llmwebsearch.com/api/v1/search" \
  -H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3}'
```

*Python: แสดงรายการแหล่งที่มาและขนาด*

```python
import os

import requests

resp = requests.post(
    "https://llmwebsearch.com/api/v1/search",
    headers={"Authorization": "Bearer " + os.environ["LLMWEBSEARCH_API_KEY"]},
    json={"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3},
    timeout=60,
)
resp.raise_for_status()
data = resp.json()
print("credits used:", data["credits_used"])
for r in data["results"]:
    size = r.get("word_count", 0)
    print(r["position"], r["title"], r["url"], r["content_status"], size, "words")

```

*Node.js 18+: แสดงหน้าแรกที่ถูกอ่าน*

```javascript
const res = await fetch('https://llmwebsearch.com/api/v1/search', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LLMWEBSEARCH_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ q: 'how to rotate api keys without downtime', max_results: 5, read: 3 }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
const first = data.results.find((r) => r.content_status === 'ok');
console.log(first ? `${first.title}\n${first.url}\n\n${first.content.slice(0, 600)}` : 'No page could be read.');

```

## อะไรส่งกลับมา?

ออบเจ็กต์ JSON ที่มี `query` ของคุณ เวลาของการเรียกใน `created_at` ราคาใน `credits_used` และอาร์เรย์ `results` ตามลำดับการจัดอันดับ ทุกผลลัพธ์มี `position`, `title`, `url`, `host` และ `snippet` พร้อมด้วย `published_at` เมื่อทราบวันที่

ฟิลด์ที่ต้องจับตา คือ `content_status` เมื่อระบุเป็น `ok` แสดงว่าหน้าถูกอ่านแล้วและเนื้อหาหลักอยู่ใน `content` พร้อมด้วย `word_count` ผลลัพธ์ที่เกินจาก `read` จะระบุ `not_requested` หน้าที่อ่านไม่ได้จะแจ้งเหตุผล เช่น `blocked_by_robots` หน้า [response format](https://llmwebsearch.com/th/docs/response/) อธิบายทุกฟิลด์

## ฉันจะเปลี่ยนพารามิเตอร์ตัวไหนบ่อยที่สุด?

พารามิเตอร์ 6 ตัวครอบคลุมเอเจนต์เกือบทุกตัว ทั้งหมดเป็นตัวเลือกเสริม

| พารามิเตอร์ | สิ่งที่เปลี่ยน |
|---|---|
| `max_results` | จำนวนผลลัพธ์จัดอันดับที่ส่งกลับ ตั้งแต่ 1 ถึง 20 |
| `read` | จำนวนผลลัพธ์แรกที่ถูกอ่าน ตั้งแต่ 0 ถึง 10 |
| `max_chars` | ขีดจำกัดความยาวของเนื้อหาแต่ละหน้า 500 ถึง 50,000 ตัวอักษร |
| `topic` และ `time_range` | ข่าวแทนหน้าเว็บ และช่วงความสดของข้อมูล |
| `include_domains` | ผลลัพธ์จากเฉพาะไซต์ที่คุณระบุ |
| `country` และ `language` | สถานที่และภาษาที่ใช้ค้นหา |

[search reference](https://llmwebsearch.com/th/docs/search/) อธิบายแต่ละตัวพร้อมตัวอย่าง รวมถึง `format` และ `exclude_domains`

## การเรียกหนึ่งครั้งใช้กี่เครดิต?

การเรียกส่วนใหญ่ใช้หนึ่งเครดิต กฎทั้งหมดมีดังนี้:

- **การค้นหาที่อ่าน 0 ถึง 3 หน้า: 1 เครดิต** รวมผลลัพธ์จัดอันดับสูงสุด 20 รายการ
- **การค้นหาที่อ่าน 4 ถึง 10 หน้า: 2 เครดิต**
- **Extract:** การอ่านหน้าเว็บที่คุณมี URL อยู่แล้วใช้ 1 เครดิตต่อกลุ่ม 3 หน้าที่เริ่มอ่านและส่งกลับพร้อมเนื้อหา สูงสุด 20 URL ต่อการเรียก; URL ที่ถูกปฏิเสธหรือล้มเหลวไม่ถูกนับ
- **ข้อผิดพลาด: 0 เครดิต** พารามิเตอร์ผิด คีย์ผิด ยอดคงเหลือว่าง หรือการค้นหาล้มเหลว ไม่มีค่าใช้จ่าย
- **หน้าที่อ่านไม่ได้** ในการค้นหาที่สำเร็จ ไม่เปลี่ยนราคา
- **การตรวจสอบยอดคงเหลือ** ด้วย `GET https://llmwebsearch.com/api/v1/credits` ฟรี

เครดิตการค้นหาไม่มีวันหมดอายุ: สิ่งที่คุณไม่ได้ใช้ในเดือนนี้ยังอยู่ให้ใช้ในปีหน้า

## จะเกิดอะไรขึ้นเมื่อไซต์ไม่ต้องการให้อ่าน?

ผลลัพธ์ยังปรากฏอยู่ พร้อมชื่อเรื่อง URL และ snippet แต่ไม่มีเนื้อหาหน้า ตัวอ่านของเราเคารพ robots.txt: แนะนำตัวว่าเป็น LLMWebSearch ทำตามกฎที่เว็บไซต์เขียนไว้สำหรับมันหรือสำหรับ robots ทั้งหมด และละเว้นเนื้อหาของหน้าใดก็ตามที่มันไม่ได้รับอนุญาตให้อ่าน เว็บไซต์ที่ตั้งค่า Content-Signal: ai-input=no ใน robots.txt จะกันหน้าเว็บของตนออกจากเนื้อหาในผลลัพธ์ของคุณ

เมื่อไซต์ตอบตัวอ่านของเราด้วยการปฏิเสธ ผลลัพธ์จะมี `content_status: "target_refused"` และ HTTP status ของไซต์เองใน `target_status` เมื่อเว็บไซต์ปิดกั้นตัวอ่านของเรา ผลลัพธ์จะกลับมาโดยไม่มีเนื้อหาและมีสถานะของเว็บไซต์: เราไม่แก้ CAPTCHA ไม่ลงชื่อเข้าใช้บัญชี และไม่หลบเลี่ยงการบล็อกหรือ paywall หน้า [errors](https://llmwebsearch.com/th/docs/errors/) แสดงรายการทุกสถานะและสถานะที่ควรลองใหม่

## ฉันควรไปที่ไหนต่อ?

- [endpoint ค้นหา](https://llmwebsearch.com/th/docs/search/) — ทุกพารามิเตอร์ของ /search พร้อมตัวอย่าง
- [endpoint ดึงเนื้อหา](https://llmwebsearch.com/th/docs/extract/) — อ่าน 1 ถึง 20 URL ที่คุณมีอยู่แล้ว
- [รูปแบบการตอบกลับ](https://llmwebsearch.com/th/docs/response/) — ทุกฟิลด์และทุก content_status
- [ข้อผิดพลาด](https://llmwebsearch.com/th/docs/errors/) — HTTP errors, สถานะหน้าเว็บ, กฎการลองใหม่
- [Python](https://llmwebsearch.com/th/docs/python/) — requests, async httpx, คำตอบพร้อมการอ้างอิง
- [Node.js](https://llmwebsearch.com/th/docs/node/) — fetch, พูลขนาดเล็ก, ลูปการอ้างอิงแบบเดียวกัน
- [curl และ jq](https://llmwebsearch.com/th/docs/curl/) — สูตรคำสั่งใน Terminal
- [MCP server](https://llmwebsearch.com/th/docs/mcp/) — search_web สำหรับ Claude Code และ Claude Desktop
- [LangChain และ LlamaIndex](https://llmwebsearch.com/th/docs/langchain/) — เครื่องมือและตัวดึงข้อมูล
- [OpenAI function calling](https://llmwebsearch.com/th/docs/openai/) — สคีมาของ tool, ลูป และ Agents SDK
- [n8n](https://llmwebsearch.com/th/docs/n8n/) — tool HTTP Request สำหรับ AI Agent
- [OpenClaw](https://llmwebsearch.com/th/docs/openclaw/) — การค้นหาของเราผ่าน MCP

## เริ่มต้นอย่างรวดเร็ว: คำถามที่พบบ่อย

### ต้องใช้ SDK ไหม?

ไม่ต้อง LLMWebSearch เป็น API แบบ HTTPS ธรรมดา จึงใช้ HTTP client ตัวไหนก็ได้ เอกสารเหล่านี้มีโค้ดที่คัดลอกไปใช้ได้ทันทีสำหรับ Python, Node.js และ curl พร้อมคำนิยาม tool สำหรับ MCP, LangChain, LlamaIndex, OpenAI function calling, n8n และ OpenClaw เราไม่ได้เผยแพร่แพ็กเกจใด ๆ

### API เขียนคำตอบให้ผมไหม?

ไม่ API ส่งคืนแหล่งข้อมูล ไม่ใช่คำตอบที่เขียนไว้: โมเดลของคุณเองอ่านหน้าเว็บ เขียนคำตอบ และอ้างอิง URL ช่วยให้คุณเลือกโมเดล พรอมต์ และสไตล์การอ้างอิงได้อย่างอิสระ

### ใส่ API key ใน URL ได้ไหม?

ได้ ในฐานะ query parameter `api_key` ของ `GET /search` ส่วน header `Authorization` เป็นตัวเลือกที่ปลอดภัยกว่า เพราะ URL มักไปปรากฏใน log และ shell history สร้าง API key หนึ่งอันต่อเอเจนต์ แอป หรือเพื่อนร่วมทีม และเพิกถอนอันใดก็ได้จากแดชบอร์ดโดยไม่กระทบอันอื่น

### มีแพ็กเกจฟรีให้ลองไหม?

ไม่มี ไม่มีแพ็กเกจฟรี: แพ็ก 5,000 การค้นหาคือวิธีลองใช้ ซื้อจากการเติมเงินขั้นต่ำ; เงินส่วนที่คุณเพิ่มเพียงเพื่อให้ถึงขั้นต่ำนั้นจะคืนให้เมื่อร้องขอภายใน 30 วัน เป็น USDT หรือ USDC ตราบใดที่ยังไม่ได้ใช้

---

LLMWebSearch: LLMWebSearch คือ web search API สำหรับ AI agents ที่คืนผลการค้นหาที่จัดอันดับแล้วพร้อมเนื้อหาของหน้าอันดับต้นๆ ในรูปแบบ Markdown จ่ายด้วยคริปโตโดยไม่ต้องอัปโหลดเอกสารยืนยันตัวตน เครดิตแบบเติมล่วงหน้าตั้งแต่ US$1.20/1K การค้นหา ไม่มีวันหมดอายุ ไม่ต้อง KYC — ไม่ต้องใช้บัตรประชาชน ไม่ต้องเซลฟี่ ไม่ต้องใช้เอกสาร จ่ายด้วยคริปโต