# Quick start URL to Markdown API: halaman pertama Anda dalam dua menit

> API Markdown URL cepat: dapatkan API key, baca halaman pertama dengan curl, Python atau Node.js, dan cek kredit. Mulai dari US$0,07/1K halaman, tanpa KYC.

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

Satu endpoint, satu parameter: kirim URL ke `/read` dan dapatkan konten utama halaman kembali sebagai Markdown. Halaman ini membawa Anda dari saldo kosong hingga panggilan yang berfungsi, lalu mengarahkan ke semua hal lainnya.

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

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

1. **Top up dengan kripto** — Kirim minimal US$25 dalam BTC, USDT, USDC, ETH, SOL, LTC. Login dengan nomor akun; email opsional.
2. **Beli paket kredit** — 10.000 halaman untuk US$3,75 sudah cukup untuk menguji setiap opsi pada URL Anda sendiri.
3. **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: baca satu halaman*

```bash
curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/first-post"
```

*Python: baca satu halaman dan simpan*

```python
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"])

```

*Node.js 18+: baca satu halaman*

```javascript
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](https://webreaderapi.com/id/docs/response/) 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](https://webreaderapi.com/id/docs/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](https://webreaderapi.com/id/docs/errors/) menjelaskan error mana yang layak dicoba ulang dan mana yang final.

## Ke mana saya selanjutnya?

- [Baca referensi endpoint](https://webreaderapi.com/id/docs/read/) — Setiap parameter /read, dengan contoh
- [Batch dan crawl](https://webreaderapi.com/id/docs/crawl/) — Hingga 100 URL per batch, atau satu situs penuh
- [Format respons](https://webreaderapi.com/id/docs/response/) — Setiap field dari jawaban
- [Error dan robots.txt](https://webreaderapi.com/id/docs/errors/) — Code, penyebab dan aturan percobaan ulang
- [Python](https://webreaderapi.com/id/docs/python/) — requests, httpx async, chunking RAG
- [Node.js](https://webreaderapi.com/id/docs/node/) — fetch, pool kecil, polling crawl
- [curl dan jq](https://webreaderapi.com/id/docs/curl/) — Resep untuk terminal
- [server MCP](https://webreaderapi.com/id/docs/mcp/) — Alat read_url untuk Claude dan Cursor
- [LangChain dan LlamaIndex](https://webreaderapi.com/id/docs/langchain/) — Loader dan alat untuk RAG
- [OpenAI function calling](https://webreaderapi.com/id/docs/openai/) — Skema dan loop alat read_url
- [n8n](https://webreaderapi.com/id/docs/n8n/) — Alat HTTP Request untuk AI Agent
- [OpenClaw](https://webreaderapi.com/id/docs/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.

---

WebReaderAPI: WebReaderAPI adalah API pembaca web untuk AI agent yang mengubah halaman web publik apa pun menjadi Markdown bersih, dibayar dengan kripto tanpa unggah identitas. Kredit prabayar mulai dari US$0,07/1K halaman tidak pernah kedaluwarsa, dan robots.txt dihormati. Tanpa KYC — tanpa identitas, tanpa selfie, tanpa dokumen. Bayar dengan kripto.