# URL'den Markdown'a API hızlı başlangıç: ilk sayfanız iki dakikada

> URL'den Markdown'a API hızlı başlangıç: anahtar alın, ilk sayfanızı curl veya Python ile okuyun. $0,07/1K sayfa itibarıyla, KYC olmadan.

- URL: https://webreaderapi.com/tr/docs/
- Son güncelleme: 2026-10-22
- Yayıncı: WebReaderAPI (https://webreaderapi.com)

Tek endpoint, tek parametre: bir URL'yi `/read` adresine gönderin ve sayfanın ana içeriğini Markdown olarak geri alın. Bu sayfa sizi boş bir bakiyeden çalışan bir çağrıya götürür, ardından diğer her şeye yönlendirir.

**Hızlı yanıt — Bir API ile bir URL'yi Markdown'a nasıl dönüştürürüm?**

URL'yi API anahtarınızı `Authorization` header'ında bulundurarak `GET https://webreaderapi.com/api/v1/read` adresine gönderin. **WebReaderAPI** sayfayı getirir, ana içeriği korur ve başlığı, yazarı, tarihi ve kelime sayısıyla birlikte Markdown olarak döndürür. Bir sayfa bir krediye mal olur (bir tarayıcı gerekiyorsa iki), Ekim 2026 itibarıyla $0,07/1K sayfa itibarıyla. KYC yok; kripto ile ödeme yapın.

## API tek tabloda

| Özellik | Değer |
| --- | --- |
| Temel URL | `https://webreaderapi.com/api/v1` |
| Bir sayfa oku | `GET` veya `POST https://webreaderapi.com/api/v1/read` |
| Çok sayıda URL veya bir site | `POST https://webreaderapi.com/api/v1/batch` ve `POST https://webreaderapi.com/api/v1/crawl`, sonuçlar `GET https://webreaderapi.com/api/v1/jobs/{job_id}` itibarıyla |
| Kalan krediler | `GET https://webreaderapi.com/api/v1/credits` (ücretsiz) |
| Kimlik doğrulama | API anahtarınızı Authorization header'ında Bearer token olarak veya api_key sorgu parametresinde gönderin |
| Faturalandırma | 1 kredi = tarayıcı olmadan 1 sayfa okuma; sayfa JavaScript render etmek için tarayıcı gerektiriyorsa 2 kredi. Başarısız olan veya bir sitenin robots.txt'inin reddettiği istek için ücret alınmaz |
| Tarayıcımız | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`, robots.txt anahtarı `WebReaderAPI` |
| En küçük pack | 10.000 sayfa karşılığında $3,75; krediler hiç süresi dolmaz |

## API anahtarını nasıl alırım?

Üç adım, doldurulacak form yok. En yavaşı, yüklemenizin blockchain onayıdır.

1. **Kripto ile ödeme yapın** — En az $25 BTC, USDT, USDC, ETH, SOL, LTC gönderin. Hesap numarasıyla giriş; email isteğe bağlı.
2. **Kredi paketi satın alın** — Kendi URL'lerinizde her seçeneği test etmek için $3,75 için 10.000 sayfa yeterlidir.
3. **Anahtarınızı kopyalayın** — Kripto yüklemeniz onaylandığında ve bir paket satın aldığınızda API anahtarınız panelinizde hazır olur. Bunu WEBREADER_API_KEY adlı bir ortam değişkeninde saklayın.

## İlk istek nasıl görünüyor?

Sayfa adresi `url` parametresinde olan düz bir HTTPS GET isteğidir. Adresi kodlayın, çünkü kendi `:` ve `/` karakterlerini içerir; curl bunu sizin için `--data-urlencode` ile yapar. Varsayılan ayarlar çoğu makale ve dokümantasyon sayfasına zaten uygundur: Markdown çıktısı, yalnızca ana içerik ve yalnızca sayfa gerektirdiğinde bir tarayıcı.

*curl: bir sayfayı oku*

```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: bir sayfayı oku ve kaydet*

```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+: bir sayfayı oku*

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

```

## Geriye ne dönüyor?

`markdown` alanında Markdown ve yanında sayfanın meta verilerini içeren bir JSON nesnesi: `title`, `description`, `author`, `published_at`, `language`, `site_name` ve `word_count`. Ne olduğunu kontrol etmenize yardımcı olan iki alan: `final_url` yönlendirmelerden sonraki adrestir ve `rendered` bir tarayıcının gerekip gerekmediğini söyler.

`credits_used` çağrının maliyetini gösterir: düz bir sayfa için 1, `rendered` `true` olduğunda 2, `country` seçtiyseniz bir fazla. [Yanıt formatı](https://webreaderapi.com/tr/docs/response/) sayfası her alanı bir örnekle listeler.

## En çok hangi seçenekleri kullanacağım?

Beş parametre çoğu ihtiyacı karşılar. Hepsi isteğe bağlıdır.

| Parametre | Ne için kullanılır |
|---|---|
| `format` | `markdown` yerine `text` veya temizlenmiş `html` almak için |
| `main_content` | Menüler dahil tüm sayfayı dönüştürmek için `false` ayarlamak |
| `render` | Tarayıcıyı zorlamak (`true`) veya yasaklamak (`false`); `auto` karar verir |
| `include_links` | Sayfanın bağlantılarını ayrı bir liste olarak almak |
| `max_chars` | Uzun sayfaları bir modelin bağlam bütçesine sığacak şekilde kesmek |

[Okuma başvurusu](https://webreaderapi.com/tr/docs/read/) `country`, `include_images` ve `timeout` dahil her parametreyi açıklar.

## Kalan kredilerimi nasıl kontrol ederim?

Aynı anahtarla `GET https://webreaderapi.com/api/v1/credits` çağırın. `credits_remaining`, `credits_used_today` ve `concurrency_limit` döndürür ve hiçbir ücrete tabi değildir. Uzun bir işin başında çalıştırın, böylece iş yarıda `402 insufficient_credits` hatasıyla başarısız olmak yerine temiz bir şekilde durur.

Ön ödemeli kreditler asla süresi dolmaz: kullanılmayan sayfalar siz kullanana kadar hesabınızda kalır, yani bir proje için satın alınan bir paket bir sonraki proje için değerini korur.

## Bir site robots'a izin vermiyorsa ne olur?

Sayfayı okumayız ve sizden ücret alınmaz. Crawler'ımız kendini `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)` olarak tanıtır ve sitenin robots.txt dosyasına uyar. İzin verilmeyen bir sayfa `403 blocked_by_robots` döndürür; isteği başka bir şekilde reddeden bir site, sitenin kendi durum koduyla `502 target_refused` döndürür.

Bir site isteğimizi reddederse, verdiği yanıtı döndürürüz: CAPTCHA'ları asla çözmeyiz, hesaplara giriş yapmayız veya bir engeli ya da ödeme duvarını aşmaya çalışmayız. [Hatalar sayfası](https://webreaderapi.com/tr/docs/errors/) hangi hataların yeniden denenmeye değer, hangilerinin kesin olduğunu açıklar.

## Bundan sonra nereye gitmeliyim?

- [Endpoint başvurusunu okuyun](https://webreaderapi.com/tr/docs/read/) — /read'in her parametresi, örneklerle
- [Toplu ve tarama (crawl)](https://webreaderapi.com/tr/docs/crawl/) — Toplu işlem başına 100 URL'ye kadar veya tüm bir site
- [Yanıt formatı](https://webreaderapi.com/tr/docs/response/) — Yanıtın her alanı
- [Hatalar ve robots.txt](https://webreaderapi.com/tr/docs/errors/) — Kodlar, nedenler ve yeniden deneme kuralları
- [Python](https://webreaderapi.com/tr/docs/python/) — requests, async httpx, RAG chunking
- [Node.js](https://webreaderapi.com/tr/docs/node/) — fetch, küçük bir havuz, crawl polling
- [curl ve jq](https://webreaderapi.com/tr/docs/curl/) — Terminal için tarifler
- [MCP sunucusu](https://webreaderapi.com/tr/docs/mcp/) — Claude ve Cursor için bir read_url aracı
- [LangChain ve LlamaIndex](https://webreaderapi.com/tr/docs/langchain/) — RAG için yükleyiciler ve araçlar
- [OpenAI function calling](https://webreaderapi.com/tr/docs/openai/) — Bir read_url araç şeması ve döngü
- [n8n](https://webreaderapi.com/tr/docs/n8n/) — Bir AI Agent için HTTP Request aracı
- [OpenClaw](https://webreaderapi.com/tr/docs/openclaw/) — MCP sunucusunu web_fetch'in yanına ekleyin

## Hızlı başlangıç: sık sorulan sorular

### Kurulacak bir SDK var mı?

Hayır. WebReaderAPI düz bir HTTPS API'dir, bu yüzden her HTTP istemcisi çalışır. Dokümanlar Python, Node.js ve curl için kopyala-yapıştır kod, MCP, LangChain, LlamaIndex ve OpenAI function calling için araç tanımları verir. Hiçbir şey paket olarak yayınlanmaz.

### Anahtarı header yerine URL'de gönderebilir miyim?

Evet, `api_key` sorgu parametresi olarak. `Authorization: Bearer` header'ı daha güvenlidir, çünkü URL'ler çoğu zaman loglara ve tarayıcı geçmişine düşer. Örneğin ajan veya proje başına bir tane olmak üzere birkaç API anahtarı oluşturun ve bunlardan istediğinizi panelinizden iptal edin.

### Başarısız bir sayfa kredi harcar mı?

Hayır. 1 kredi = tarayıcı olmadan 1 sayfa okuma; sayfa JavaScript render etmek için tarayıcı gerektiriyorsa 2 kredi. Başarısız olan veya bir sitenin robots.txt'inin reddettiği istek için ücret alınmaz. Yalnızca içerikle dönen bir sayfa faturalandırılır.

### Satın almadan önce deneyebilir miyim?

Ücretsiz katman yok. Ücretsiz katman yoktur: test etmenin yolu en küçük pakettir, minimum yükleme tutarından ödenir ve yalnızca bu minimuma ulaşmak için eklenen tutar, harcanmadığı sürece 30 gün içinde talep üzerine USDT veya USDC olarak geri gönderilebilir.

---

WebReaderAPI: WebReaderAPI, AI ajanları için bir web reader API'sidir; herkese açık herhangi bir web sayfasını temiz Markdown'a dönüştürür ve kimlik yüklemeden kripto ile ödenir. $0,07/1K sayfa başlangıçlı ön ödemeli kreditler asla süresi dolmaz ve robots.txt'e uyulur. KYC yok — kimlik yok, selfie yok, belge yok. Kripto ile ödeme yapın.