Glosarium web search API

Antarmuka yang menjalankan web search atas permintaan dan mengembalikan hasilnya sebagai data terstruktur, biasanya JSON, bukan halaman yang ditujukan untuk dibaca manusia.

Halaman hasil mesin pencari: apa yang ditampilkan mesin pencari untuk sebuah kueri. SERP API mengembalikan halaman itu sebagai data, tanpa membaca halaman-halaman yang didaftarkannya.

Daftar halaman yang dikembalikan oleh pencarian, dalam urutan yang dinilai mesin pencari paling relevan. LLMWebSearch mempertahankan urutan itu dan memberi nomor pada setiap hasil dengan position.

Kutipan singkat di bawah judul setiap hasil. Berguna untuk memilih apa yang akan dibaca, tetapi terlalu pendek untuk menjawab sebagian besar pertanyaan sendiri.

Kata-kata yang dikirim ke pencarian. Agen sering menulis ulang pertanyaan pengguna menjadi satu atau beberapa kueri yang lebih pendek sebelum mencari.

Token khusus di dalam kueri, seperti tanda kutip untuk frasa persis atau site: untuk tetap berada di satu domain. Parameter q meneruskannya apa adanya.

Pencarian yang dijalankan pada saat permintaan, bukan pencarian dalam indeks yang dibangun sebelumnya. Hasil berasal dari pencarian web langsung yang dijalankan pada saat panggilan Anda, dalam urutan peringkat dari mesin pencari; tidak ada yang disajikan dari indeks lama.

Pencarian yang dibatasi pada artikel berita, biasanya dengan tanggal. Setel topic ke news, dan tambahkan time_range untuk hanya menyimpan berita terbaru.

Aturan yang membatasi hasil ke situs tertentu atau menghapus situs lain. Parameter include_domains dan exclude_domains masing-masing menerima hingga 20 domain.

Bagian dari layanan yang membuka halaman hasil teratas dan mengekstrak teksnya. Layanan kami memperkenalkan diri sebagai LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/); halaman page reader menjelaskannya.

Nama yang dikirim klien pada setiap permintaan web. Reader yang menyebutkan nama aslinya memungkinkan pemilik situs mengenalinya dan menetapkan aturan untuknya.

File teks di root sebuah situs web yang memberi tahu robot path mana yang boleh diambil. Standarnya adalah RFC 9309. 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.

Baris dalam robots.txt yang menyatakan bagaimana konten boleh digunakan, misalnya ai-input=no untuk menolak penggunaan sebagai input AI. Situs yang menyetel Content-Signal: ai-input=no di robots.txt-nya menjaga halaman-halamannya agar tidak masuk ke konten hasil Anda.

Mempertahankan teks artikel atau dokumentasi sebuah halaman dan membuang menu, footer, banner cookie, serta iklan, sehingga model membaca apa yang penting.

Format teks ringan di mana # menandai sebuah heading dan - sebuah item daftar. Model membacanya dengan baik, dan biaya tokennya lebih sedikit dibandingkan HTML untuk halaman yang sama.

Browser tanpa jendela yang dijalankan oleh kode. Ini memungkinkan reader melihat teks halaman yang baru muncul setelah JavaScript berjalan.

Gerbang yang menyimpan konten untuk pelanggan berbayar. Reader tidak pernah masuk dan tidak pernah mengakali paywall; halaman seperti itu dikembalikan tanpa konten.

Field yang menyatakan apakah halaman suatu hasil sudah dibaca dan, jika belum, alasannya: ok, not_requested, blocked_by_robots, target_refused dan lainnya yang tercantum di dokumentasi.

Large language model: model yang dilatih pada teks dan menulis teks. Pengetahuannya berhenti pada tanggal pelatihan, itulah sebabnya ia membutuhkan pencarian untuk hal-hal terbaru.

Memberi model sumber sebagai dasar jawabannya, lalu memintanya mengutip sumber tersebut. Hasil pencarian dengan teks halaman adalah cara paling umum untuk grounding di web.

Disebut juga function calling. Model meminta menjalankan sebuah tool, seperti web_search, dengan argumen yang ia pilih; kode Anda menjalankannya dan mengembalikan output.

Model Context Protocol: standar terbuka untuk mengekspos tool ke klien AI seperti Claude Desktop atau Cursor. Server MCP kecil dapat membungkus search API sebagai tool.

Program di mana model memutuskan langkah berikutnya, memanggil tool, membaca hasilnya dan mengulanginya hingga tugas selesai. Pencarian web sering menjadi tool pertamanya.

Retrieval-augmented generation: ambil teks yang relevan lebih dulu, masukkan ke prompt, lalu hasilkan. Dengan web search API, langkah pengambilan adalah web langsung.

Pola agent yang merencanakan banyak kueri, membaca banyak halaman dan menulis laporan dengan kutipan. Ia dapat menjalankan puluhan pencarian untuk satu pertanyaan.

Jumlah teks yang dapat diterima model sekaligus, diukur dalam token. Atur max_chars untuk membatasi berapa banyak setiap halaman yang masuk ke jendela tersebut.

Satuan yang dibaca dan ditagih model, kira-kira satu kata pendek atau sebagian kata. Markdown yang bersih menghabiskan lebih sedikit token daripada HTML mentah.

Tautan dari suatu pernyataan dalam jawaban ke sumber asalnya. Mengembalikan sumber alih-alih jawaban tertulis memungkinkan model Anda mengutip persis apa yang dibacanya.

Pernyataan yang dibuat-buat model dengan penuh keyakinan. Grounding pada sumber terbaru dan meminta kutipan menguranginya; tetapi tidak menghilangkannya.

Yang dihabiskan setiap panggilan. 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.

Sekumpulan kredit prabayar, dari 5.000 pencarian hingga 1.000.000 pencarian. Kredit pencarian tidak memiliki tanggal kedaluwarsa: yang tidak Anda pakai bulan ini masih ada tahun depan.

Pembayaran kripto yang mengisi saldo Anda, minimal US$25. Paket kemudian dibeli dari saldo.

Jumlah panggilan yang boleh dilakukan suatu akun per menit. Setiap akun memiliki batas panggilan per menit yang ditampilkan di dashboard; hubungi support dan batas itu bisa dinaikkan.

Protokol yang memungkinkan klien membayar satu permintaan HTTP dalam stablecoin, tanpa akun. Beberapa search API menerimanya; LLMWebSearch dibayar dari saldo prabayar.

Know your customer: pemeriksaan identitas seperti dokumen identitas atau selfie. LLMWebSearch tidak meminta apa pun; halaman tanpa KYC menjelaskan apa yang tetap berlaku.