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
| 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.
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ı.
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.
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_KEYadlı 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 -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));
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ı 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 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ı hangi hataların yeniden denenmeye değer, hangilerinin kesin olduğunu açıklar.
Bundan sonra nereye gitmeliyim?
- Endpoint başvurusunu okuyun /read'in her parametresi, örneklerle
- Toplu ve tarama (crawl) Toplu işlem başına 100 URL'ye kadar veya tüm bir site
- Yanıt formatı Yanıtın her alanı
- Hatalar ve robots.txt Kodlar, nedenler ve yeniden deneme kuralları
- Python requests, async httpx, RAG chunking
- Node.js fetch, küçük bir havuz, crawl polling
- curl ve jq Terminal için tarifler
- MCP sunucusu Claude ve Cursor için bir read_url aracı
- LangChain ve LlamaIndex RAG için yükleyiciler ve araçlar
- OpenAI function calling Bir read_url araç şeması ve döngü
- n8n Bir AI Agent için HTTP Request aracı
- 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.