# Quick start web search API: pencarian pertama Anda dalam dua menit

> Quick start web search API: dapatkan API key, jalankan pencarian pertama dengan curl, Python atau Node.js, dan baca halaman teratas sebagai Markdown. Tanpa KYC.

- URL: https://llmwebsearch.com/id/docs/
- Terakhir diperbarui: 2026-10-22
- Penerbit: LLMWebSearch (https://llmwebsearch.com)

Satu endpoint melakukan semuanya: kirim pertanyaan ke `/search` dan dapatkan hasil berperingkat kembali, dengan halaman-halaman pertama sudah dibaca dan dibersihkan menjadi Markdown. Halaman ini membawa Anda dari saldo kosong ke panggilan yang berfungsi, lalu mengarahkan ke setiap halaman dokumentasi lainnya.

**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

| Atribut | Nilai |
| --- | --- |
| 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.

1. **Isi saldo Anda dengan kripto** — Kirim minimal US$25 dalam BTC, USDT, USDC, ETH, SOL, LTC. Masuk dengan nomor akun; alamat email bersifat opsional.
2. **Beli paket pencarian** — 5.000 pencarian untuk US$9,25 sudah cukup untuk menyambungkan pencarian ke satu agen dan mencoba semua opsi.
3. **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: satu pencarian, 3 halaman teratas dibaca*

```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: daftar sumber dan ukurannya*

```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+: cetak halaman pertama yang dibaca*

```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.');

```

## 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](https://llmwebsearch.com/id/docs/response/) 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](https://llmwebsearch.com/id/docs/search/) 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/credits` gratis.

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](https://llmwebsearch.com/id/docs/errors/) mencantumkan setiap status dan yang layak dicoba ulang.

## Ke mana saya lanjut?

- [Endpoint pencarian](https://llmwebsearch.com/id/docs/search/) — Setiap parameter /search, dengan contoh
- [Endpoint ekstraksi](https://llmwebsearch.com/id/docs/extract/) — Baca 1 hingga 20 URL yang sudah Anda miliki
- [Format respons](https://llmwebsearch.com/id/docs/response/) — Setiap field dan setiap content_status
- [Error](https://llmwebsearch.com/id/docs/errors/) — Error HTTP, status halaman, aturan percobaan ulang
- [Python](https://llmwebsearch.com/id/docs/python/) — requests, httpx async, jawaban dengan sitasi
- [Node.js](https://llmwebsearch.com/id/docs/node/) — fetch, kumpulan koneksi kecil, loop sitasi yang sama
- [curl dan jq](https://llmwebsearch.com/id/docs/curl/) — Resep terminal
- [Server MCP](https://llmwebsearch.com/id/docs/mcp/) — search_web untuk Claude Code dan Claude Desktop
- [LangChain dan LlamaIndex](https://llmwebsearch.com/id/docs/langchain/) — Alat dan retriever
- [OpenAI function calling](https://llmwebsearch.com/id/docs/openai/) — Skema tool, loop, dan Agents SDK
- [n8n](https://llmwebsearch.com/id/docs/n8n/) — Tool HTTP Request untuk AI Agent
- [OpenClaw](https://llmwebsearch.com/id/docs/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.

---

LLMWebSearch: LLMWebSearch adalah API pencarian web untuk agen AI yang mengembalikan hasil berperingkat beserta konten halaman teratas dalam Markdown, dibayar dengan kripto tanpa unggah ID. Kredit prabayar mulai dari US$1,20/1K pencarian tidak pernah kedaluwarsa. Tanpa KYC — tanpa ID, tanpa selfie, tanpa dokumen. Bayar dengan kripto.