Jawaban singkat
Bagaimana cara menjalankan pencarian pertama saya dengan web search API untuk agen AI?
Kirim pertanyaan Anda ke POST https://llmwebsearch.com/api/v1/search dengan API key Anda sebagai Bearer token. LLMWebSearch menjalankan pencarian web live dan mengembalikan hingga 20 hasil berperingkat, dengan 3 halaman pertama dibaca dan dikembalikan sebagai Markdown. Satu kredit membayar seluruh panggilan itu, mulai dari US$1,20/1K pencarian per Oktober 2026. Tanpa KYC; bayar dengan kripto.
API dalam satu kartu
| Base URL | https://llmwebsearch.com/api/v1 |
|---|---|
| Pencarian | POST atau GET https://llmwebsearch.com/api/v1/search |
| Baca URL yang sudah Anda miliki | POST https://llmwebsearch.com/api/v1/extract |
| Sisa kredit | GET https://llmwebsearch.com/api/v1/credits, gratis |
| Autentikasi | Kirim API key Anda sebagai Bearer token di header Authorization, atau sebagai parameter kueri api_key |
| Penagihan | Satu kredit membayar satu pencarian: hingga 20 hasil berperingkat, dengan halaman dari 3 hasil teratas dibaca dan dikembalikan sebagai Markdown. Membaca 4 hingga 10 halaman menjadi 2 kredit. Panggilan yang berakhir dengan error tidak dikenakan biaya |
| Pembaca halaman kami | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/), token robots.txt LLMWebSearch |
| Paket terkecil | 5.000 pencarian untuk US$9,25; kredit tidak pernah kedaluwarsa |
Bagaimana cara mendapatkan API key?
Tidak ada formulir pendaftaran. Menunggu blockchain mengonfirmasi top-up Anda adalah bagian terlama.
Isi saldo Anda dengan kripto
Kirim minimal US$25 dalam BTC, USDT, USDC, ETH, SOL, LTC. Masuk dengan nomor akun; alamat email bersifat opsional.
Beli paket pencarian
5.000 pencarian untuk US$9,25 sudah cukup untuk menyambungkan pencarian ke satu agen dan mencoba semua opsi.
Salin API key
Setelah top-up kripto Anda terkonfirmasi dan sebuah paket dibeli, API key Anda sudah tersedia di dashboard. Simpan di environment variable bernama
LLMWEBSEARCH_API_KEY.
Seperti apa pencarian pertama?
Ini adalah satu HTTPS POST dengan body JSON kecil. Hanya q yang wajib: pertanyaan atau kata kunci, seperti yang akan diketik orang. Default sudah cocok untuk sebagian besar agen. Anda mendapat 5 hasil berperingkat, dan halaman di balik 3 hasil pertama dibaca dan dikembalikan sebagai Markdown maksimal 6.000 karakter per halaman.
Tiga cuplikan di bawah mengirim pencarian yang sama. Pilih yang sesuai dengan stack Anda, set LLMWEBSEARCH_API_KEY di shell, dan jalankan.
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}'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")
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.');
Apa yang dikembalikan?
Objek JSON dengan query Anda, waktu panggilan dalam created_at, harga dalam credits_used, dan array results dalam urutan peringkat. Setiap hasil memiliki position, title, url, host dan snippet, plus published_at jika tanggalnya diketahui.
Field yang perlu diperhatikan adalah content_status. Saat bernilai ok, halaman dibaca dan konten utamanya ada di content, dengan word_count. Hasil di luar read menyatakan not_requested. Halaman yang tidak dapat dibaca menyatakan alasannya, misalnya blocked_by_robots. Halaman format respons menjelaskan setiap field.
Parameter mana yang paling sering akan saya ubah?
Enam parameter mencakup hampir semua agen. Semuanya opsional.
| Parameter | Apa yang diubah |
|---|---|
max_results | Berapa banyak hasil berperingkat yang dikembalikan, dari 1 hingga 20 |
read | Berapa banyak hasil pertama yang dibaca, dari 0 hingga 10 |
max_chars | Batas panjang konten setiap halaman, 500 hingga 50.000 karakter |
topic dan time_range | Berita bukan halaman web, dan jendela kebaruan |
include_domains | Hasil hanya dari situs yang Anda daftarkan |
country dan language | Di mana dan dalam bahasa apa pencarian dijalankan |
Referensi pencarian mendokumentasikan masing-masing dengan contoh, plus format dan exclude_domains.
Berapa kredit yang digunakan per panggilan?
Sebagian besar panggilan menggunakan satu. Aturan lengkapnya:
- Pencarian yang membaca 0 hingga 3 halaman: 1 kredit. Termasuk hingga 20 hasil berperingkat.
- Pencarian yang membaca 4 hingga 10 halaman: 2 kredit.
- Extract: Membaca halaman yang URL-nya sudah Anda miliki dikenakan 1 kredit untuk setiap grup 3 halaman yang mulai dikembalikan beserta kontennya, hingga 20 URL per panggilan; URL yang ditolak atau gagal tidak dihitung.
- Error: 0 kredit. Parameter salah, API key salah, saldo kosong, atau pencarian gagal tidak dikenakan biaya.
- Halaman yang tidak dapat dibaca dalam pencarian yang berhasil tidak mengubah harganya.
- Memeriksa saldo Anda dengan
GET https://llmwebsearch.com/api/v1/creditsgratis.
Kredit pencarian tidak memiliki tanggal kedaluwarsa: yang tidak Anda pakai bulan ini masih ada tahun depan.
Apa yang terjadi jika situs tidak ingin dibaca?
Hasilnya tetap muncul, dengan judul, URL, dan snippet, tetapi tanpa konten halaman. Pembaca kami mematuhi robots.txt: ia memperkenalkan diri sebagai LLMWebSearch, mengikuti aturan yang ditulis situs untuknya atau untuk semua robot, dan mengabaikan konten halaman apa pun yang tidak diizinkan untuk dibaca. Situs yang menyetel Content-Signal: ai-input=no di robots.txt-nya menjaga halaman-halamannya agar tidak masuk ke konten hasil Anda.
Saat situs menjawab pembaca kami dengan penolakan, hasilnya membawa content_status: "target_refused" dan status HTTP situs itu sendiri di target_status. Saat situs menolak pembaca kami, hasil kembali tanpa konten dan dengan status dari situs tersebut: kami tidak pernah memecahkan CAPTCHA, masuk ke akun, atau mengakali blokir atau paywall. Halaman error mencantumkan setiap status dan yang layak dicoba ulang.
Ke mana saya lanjut?
- Endpoint pencarian Setiap parameter /search, dengan contoh
- Endpoint ekstraksi Baca 1 hingga 20 URL yang sudah Anda miliki
- Format respons Setiap field dan setiap content_status
- Error Error HTTP, status halaman, aturan percobaan ulang
- Python requests, httpx async, jawaban dengan sitasi
- Node.js fetch, kumpulan koneksi kecil, loop sitasi yang sama
- curl dan jq Resep terminal
- Server MCP search_web untuk Claude Code dan Claude Desktop
- LangChain dan LlamaIndex Alat dan retriever
- OpenAI function calling Skema tool, loop, dan Agents SDK
- n8n Tool HTTP Request untuk AI Agent
- OpenClaw Pencarian kami melalui MCP
Mulai cepat: pertanyaan umum
Apakah saya perlu SDK?
Tidak. LLMWebSearch adalah API HTTPS biasa, jadi HTTP client apa pun bisa dipakai. Dokumentasi ini menyediakan kode siap salin untuk Python, Node.js dan curl, serta definisi tool untuk MCP, LangChain, LlamaIndex, OpenAI function calling, n8n dan OpenClaw. Kami tidak menerbitkan package.
Apakah API menuliskan jawabannya untuk saya?
Tidak. API mengembalikan sumber, bukan jawaban tertulis: model Anda sendiri yang membaca halaman, menulis balasan, dan mengutip URL-nya. Itu membuat Anda bebas memilih model, prompt dan gaya sitasi.
Bisakah saya menaruh API key di URL?
Ya, sebagai parameter kueri api_key pada GET /search. Header Authorization adalah pilihan yang lebih aman, karena URL tercatat di log dan riwayat shell. Buat satu API key per agen, aplikasi, atau rekan tim dan cabut salah satunya dari dashboard tanpa mengganggu yang lain.
Apakah ada tier gratis untuk mencobanya?
Tidak. Tidak ada tier gratis: paket 5.000 pencarian adalah cara untuk mencobanya, dibeli dari top-up minimum; apa pun yang Anda tambahkan hanya untuk mencapai minimum itu dikembalikan atas permintaan dalam 30 hari, dalam USDT atau USDC, selama belum terpakai.