Jawaban singkat
Bagaimana cara mengubah URL menjadi Markdown dengan API?
Kirim URL ke GET https://webreaderapi.com/api/v1/read dengan API key Anda di header Authorization. WebReaderAPI mengambil halaman, mempertahankan konten utama dan mengembalikannya sebagai Markdown beserta judul, penulis, tanggal dan jumlah katanya. Satu halaman berbiaya satu kredit (dua jika membutuhkan browser), mulai dari US$0,07/1K halaman per Oktober 2026. Tanpa KYC; bayar dengan kripto.
API dalam satu tabel
| Base URL | https://webreaderapi.com/api/v1 |
|---|---|
| Baca satu halaman | GET atau POST https://webreaderapi.com/api/v1/read |
| Banyak URL atau satu situs | POST https://webreaderapi.com/api/v1/batch dan POST https://webreaderapi.com/api/v1/crawl, hasil dari GET https://webreaderapi.com/api/v1/jobs/{job_id} |
| Kredit tersisa | GET https://webreaderapi.com/api/v1/credits (gratis) |
| Autentikasi | Kirim API key Anda di header Authorization sebagai Bearer token, atau di parameter kueri api_key |
| Penagihan | 1 kredit = 1 halaman dibaca tanpa browser; 2 kredit jika halaman memerlukan browser untuk merender JavaScript. Permintaan yang gagal, atau yang ditolak oleh robots.txt suatu situs, tidak dikenai biaya |
| Crawler kami | WebReaderAPI/1.0 (+https://webreaderapi.com/bot/), token robots.txt WebReaderAPI |
| Paket terkecil | 10.000 halaman untuk US$3,75; kredit tidak pernah kedaluwarsa |
Bagaimana cara mendapatkan API key?
Tiga langkah, tanpa formulir yang harus diisi. Yang paling lambat adalah konfirmasi blockchain untuk top-up Anda.
Top up dengan kripto
Kirim minimal US$25 dalam BTC, USDT, USDC, ETH, SOL, LTC. Login dengan nomor akun; email opsional.
Beli paket kredit
10.000 halaman untuk US$3,75 sudah cukup untuk menguji setiap opsi pada URL Anda sendiri.
Salin API key Anda
API key Anda siap di dashboard setelah top-up kripto Anda dikonfirmasi dan Anda telah membeli pack. Simpan di environment variable bernama
WEBREADER_API_KEY.
Seperti apa permintaan pertama?
Ini adalah HTTPS GET biasa dengan alamat halaman di parameter url. Encode alamatnya, karena alamat itu mengandung karakter : dan / sendiri; curl melakukannya untuk Anda dengan --data-urlencode. Pengaturan default sudah cocok untuk sebagian besar artikel dan halaman dokumentasi: output Markdown, hanya konten utama, dan browser hanya saat halaman membutuhkannya.
curl -sG "https://webreaderapi.com/api/v1/read" \
-H "Authorization: Bearer $WEBREADER_API_KEY" \
--data-urlencode "url=https://example.com/blog/first-post"import os
import requests
resp = requests.get(
"https://webreaderapi.com/api/v1/read",
headers={"Authorization": "Bearer " + os.environ["WEBREADER_API_KEY"]},
params={"url": "https://example.com/blog/first-post"},
timeout=70,
)
resp.raise_for_status()
page = resp.json()
print(page["title"], "-", page["word_count"], "words,", page["credits_used"], "credit(s)")
with open("first-post.md", "w", encoding="utf-8") as f:
f.write(page["markdown"])
const params = new URLSearchParams({ url: 'https://example.com/blog/first-post' });
const res = await fetch(`https://webreaderapi.com/api/v1/read?${params}`, {
headers: { Authorization: `Bearer ${process.env.WEBREADER_API_KEY}` },
});
const page = await res.json();
if (!res.ok) throw new Error(`${page.error.code}: ${page.error.message}`);
console.log(page.title, page.word_count, 'words');
console.log(page.markdown.slice(0, 500));
Apa yang dikembalikan?
Sebuah objek JSON dengan Markdown di field markdown dan metadata halaman di sampingnya: title, description, author, published_at, language, site_name dan word_count. Dua field membantu Anda memeriksa apa yang terjadi: final_url adalah alamat setelah redirect, dan rendered memberi tahu Anda apakah browser diperlukan.
credits_used menunjukkan berapa biaya panggilan: 1 untuk halaman biasa, 2 saat rendered adalah true, satu lagi jika Anda memilih country. Halaman format respons mencantumkan setiap field dengan contoh.
Opsi mana yang paling sering akan saya gunakan?
Lima parameter mencakup sebagian besar kebutuhan. Semuanya opsional.
| Parameter | Gunakan untuk |
|---|---|
format | Dapatkan text atau html yang sudah dibersihkan alih-alih markdown |
main_content | Setel false untuk mengubah seluruh halaman, termasuk menu |
render | Paksa (true) atau larang (false) browser; auto yang memutuskan |
include_links | Dapatkan tautan halaman sebagai daftar terpisah |
max_chars | Potong halaman panjang agar sesuai dengan budget konteks model |
Referensi read menjelaskan setiap parameter, termasuk country, include_images dan timeout.
Bagaimana cara memeriksa kredit saya yang tersisa?
Panggil GET https://webreaderapi.com/api/v1/credits dengan API key yang sama. Ini mengembalikan credits_remaining, credits_used_today dan concurrency_limit Anda, dan tidak memakan biaya. Jalankan di awal tugas panjang agar tugas berhenti dengan rapi alih-alih gagal karena 402 insufficient_credits di tengah jalan.
Kredit prabayar tidak pernah kedaluwarsa: halaman yang belum digunakan tetap ada di akun Anda sampai Anda memakainya, jadi pack yang dibeli untuk satu proyek tetap bernilai untuk proyek berikutnya.
Apa yang terjadi jika situs tidak mengizinkan robot?
Kami tidak membaca halaman tersebut, dan Anda tidak dikenakan biaya. Crawler kami memperkenalkan diri sebagai WebReaderAPI/1.0 (+https://webreaderapi.com/bot/) dan mematuhi robots.txt situs. Halaman yang tidak diizinkan mengembalikan 403 blocked_by_robots; situs yang menolak permintaan dengan cara lain mengembalikan 502 target_refused dengan status code milik situs itu sendiri.
Jika suatu situs menolak permintaan kami, kami mengembalikan jawabannya: kami tidak pernah menyelesaikan CAPTCHA, masuk ke akun, atau mencoba mengatasi blokir atau paywall. Halaman errors menjelaskan error mana yang layak dicoba ulang dan mana yang final.
Ke mana saya selanjutnya?
- Baca referensi endpoint Setiap parameter /read, dengan contoh
- Batch dan crawl Hingga 100 URL per batch, atau satu situs penuh
- Format respons Setiap field dari jawaban
- Error dan robots.txt Code, penyebab dan aturan percobaan ulang
- Python requests, httpx async, chunking RAG
- Node.js fetch, pool kecil, polling crawl
- curl dan jq Resep untuk terminal
- server MCP Alat read_url untuk Claude dan Cursor
- LangChain dan LlamaIndex Loader dan alat untuk RAG
- OpenAI function calling Skema dan loop alat read_url
- n8n Alat HTTP Request untuk AI Agent
- OpenClaw Tambahkan server MCP di samping web_fetch
Quick start: pertanyaan umum
Apakah ada SDK yang perlu diinstal?
Tidak. WebReaderAPI adalah API HTTPS biasa, jadi klien HTTP apa pun berfungsi. Dokumentasi menyediakan kode siap salin untuk Python, Node.js dan curl, serta definisi alat untuk MCP, LangChain, LlamaIndex dan OpenAI function calling. Tidak ada yang diterbitkan sebagai package.
Bisakah saya mengirim API key di URL alih-alih header?
Ya, sebagai parameter kueri api_key. Header Authorization: Bearer lebih aman, karena URL sering kali berakhir di log dan riwayat browser. Buat beberapa API key, misalnya satu per agent atau proyek, dan cabut salah satunya dari dashboard Anda.
Apakah halaman yang gagal memakai satu kredit?
Tidak. 1 kredit = 1 halaman dibaca tanpa browser; 2 kredit jika halaman memerlukan browser untuk merender JavaScript. Permintaan yang gagal, atau yang ditolak oleh robots.txt suatu situs, tidak dikenai biaya. Hanya halaman yang kembali dengan konten yang ditagih.
Bisakah saya mencobanya sebelum membeli?
Tidak ada tier gratis. Tidak ada free tier: pack terkecil adalah cara untuk menguji, dibayar dari top-up minimum, dan jumlah yang ditambahkan hanya untuk mencapai minimum tersebut dapat dikembalikan atas permintaan dalam 30 hari, dalam USDT atau USDC, selama belum digunakan.