Hızlı yanıt
Web reader API nedir?
Web reader API, bir URL alıp sayfayı yükleyen ve ana içeriğini genellikle Markdown olarak, başlık, yazar ve tarih gibi metadata ile birlikte temiz metin olarak döndüren bir hizmettir. AI agent'lar ve RAG pipeline'ları bunu ham HTML yerine kullanır. WebReaderAPI bunlardan biridir: sayfa başına bir kredi, Ekim 2026 itibarıyla $0,07/1K sayfa'den başlayan fiyatlarla, robots.txt'e uyularak, KYC olmadan ve kripto ile ödeme.
Tek tabloda web reader API
| Girdi | Herkese açık bir web sayfasının veya PDF'in URL'si |
|---|---|
| Çıktı | Ana içeriğin Markdown'ı ya da düz metni; başlık, yazar, tarih ve dil ile birlikte |
| Kaldırılan | Gezinme menüleri, çerez banner'ları, reklamlar, kenar çubukları, altbilgiler, script'ler ve stiller |
| JavaScript sayfaları | Ham HTML çok az metin içerdiğinde headless tarayıcıda render edilir |
| Tipik faturalama | Sayfa başına veya kredi başına; bazı sağlayıcılar çıktı token'ı başına faturalar |
| Örnek istek | GET https://webreaderapi.com/api/v1/read?url=https://example.com/post |
Web reader API adım adım ne yapar?
Her sayfa-metin pipeline'ının ihtiyaç duyduğu beş işi tek bir çağrıda yapar:
- İzni kontrol eder. Dikkatli bir reader, hiçbir şeyi getirmeden önce sitenin robots.txt dosyasına hem kendi adı hem de tüm robot'lar için bakar.
- Sayfayı getirir. HTML'i indirir, yönlendirmeleri takip eder ve bir zaman aşımında durur.
- Gerekince render eder. HTML, JavaScript ile doldurulan boş bir kabuk ise sayfayı headless tarayıcıda yükler ve sonucu okur.
- Ana içeriği çıkarır. Readability tarzı bir adım makaleyi veya dokümantasyon gövdesini bulur ve etrafındaki sayfa süslerini atar.
- Dönüştürür ve betimler. İçeriği Markdown olarak yazar ve metadata ekler: başlık, yazar, yayın tarihi, dil ve kelime sayısı.
Çağıran taraf, Markdown'ı içeren tek bir JSON nesnesi alır. Bir model bunu bir anda okuyabilir veya bir pipeline onu bir vector store için parçalara bölebilir.
Modeller neden HTML yerine Markdown'a ihtiyaç duyar?
Çünkü bir HTML sayfasının çoğu içerik değildir. Menüler, script etiketleri, izleme kodu ve düzen işaretlemesi, bir modelin okumak zorunda olduğu ve sizin ödemek zorunda kaldığınız token'ları kullanır. Markdown ise anlam taşıyan kısımları korur: başlıklar, listeler, tablolar, bağlantılar ve vurgu.
Cloudflare, 12 Şubat 2026'da "Markdown for Agents" özelliğini başlattığında somut bir örnek verdi: bir sayfa HTML olarak 16.180 token'dan Markdown olarak 3.150 token'a düştü, yaklaşık %80 daha az. Sonuçlar sayfaya göre değişir, ancak çoğu makale ve dokümantasyon sayfasında yön aynıdır.
Web reader API'nin scraping API'sinden farkı nedir?
Scraping API sunucunun gönderdiğini döndürür; reader ise bir kişinin okuyacağını döndürür. Scraping API'leri sayfaları ölçekli olarak getirmek, genellikle fiyat veya ürün adı gibi belirli alanları çekmek için kurulmuştur ve genellikle ham HTML ya da sizin tanımladığınız yapılandırılmış JSON döndürür.
Bir web reader daha dar ve daha iddialıdır. Ana içeriğin ne olduğuna karar verir, gerisini kaldırır ve temiz metin yazar. Bir sonraki tüketici bir dil modeli, bir arama indeksi veya bir özet okuyan kişi ise doğru araç budur. Bir ürün ızgarasının her alanına ihtiyacınız varsa yanlış araçtır; bunun için tam HTML veya şema tabanlı bir çıkarma istersiniz.
SERP API'den farkı nedir?
SERP API "hangi sayfalar bundan bahsediyor?" sorusunu yanıtlar; reader "bu sayfa ne diyor?" sorusunu yanıtlar. Arama, bir sorgu için başlıklar ve snippet'lerle birlikte bir URL listesi döndürür. Reader bu URL'lerden birini alır ve tam metnini döndürür.
Agent'lar genellikle ikisini zincirler: aday sayfaları bulmak için arama, ardından atıflarla yanıtlamak için en iyi üç-dört sayfayı okuma. Adımları ayrı tutmak, kaç sayfa okuyacağınızı seçmenizi sağlar; bu da token ve krediden tasarruf ettirir.
API yerine açık kaynak araçları çalıştırabilir miyim?
Evet, ve birçok ekip böyle başlar. Mozilla'nın Readability'si bir tarayıcı bağlamında sayfanın ana içeriğini çıkarır; Trafilatura Python'da çıkarma yapar; Microsoft'un MarkItDown'ı PDF'ler dahil belgeleri Markdown'a dönüştürür; Crawl4AI tarama ve Markdown çıktısını birleştirir.
Kütüphane kolay kısımdır. Üretimde çalıştırmak ise JavaScript sayfaları için headless tarayıcı barındırmak, robots.txt kontrol etmek, zaman aşımları, yönlendirmeler ve karakter kümeleriyle ilgilenmek, PDF'leri dönüştürmek ve tüm bunları güncel tutmak demektir. O makineyi işletmek yerine sayfa başına ödemeyi tercih ediyorsanız API'ye değer; hacimler istikrarlıysa ve çalıştırmak için zamanınız varsa kütüphaneye değer.
Web reader API'leri nasıl ücretlendirir?
2026'da üç faturalama modeli yaygındır. Kredi tabanlı planlar sayfa başına belirli sayıda kredi ücretlendirir: 22 Ekim 2026'da okunan Firecrawl'ın fiyatlandırma sayfası, kazınan sayfa başına 1 kredi ve JSON formatı için sayfa başına 4 ek kredi sayar. Token tabanlı faturalama döndürülen metin için ücret alır: Jina Reader 6 Mayıs 2025'ten beri bu şekilde fiyatlandırıyor ve her yeni anahtara 10 milyon ücretsiz token veriyor. Aylık planlar kredilerini her döngüde sıfırlarken, ön ödemeli paketler kredileri korur.
WebReaderAPI hiç süresi dolmayan ön ödemeli krediler kullanı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. 10.000 sayfa $3,75 tutar ve Ekim 2026 itibarıyla oran 5.000.000 sayfa üzerinde $0,07/1K sayfa'e düşer.
Bir web reader API'si seçmeden önce neyi kontrol etmeliyim?
Kendi URL'lerinizden yirmi tanesinde test edin ve altı şeye bakın:
- Çıkarma kalitesi. Markdown makaleyi korur ve tablolar ile kod blokları dahil gerisini atar mı?
- JavaScript. Tarayıcıda oluşturulan sayfalar metinle mi dönüyor ve render etmenin maliyeti ne?
- PDF'ler. Destekleniyor mu ve sayfalar nasıl sayılıyor?
- Site sahiplerinin tercihleri. Hizmet robots.txt'e ve beyan edilen AI tercihlerine uyuyor mu ve bunu dokümanlarında söylüyor mu?
- Başarısızlıklar. Başarısız ve reddedilen sayfalar ücretlendiriliyor mu?
- Bütçe kontrolü. Her sayfanın uzunluğunu sınırlayabiliyor musunuz ve krediler süresi doluyor mu?
Web reader API fiyatları karşılaştırmamız ana sağlayıcıları tarihleriyle yan yana koyar.
Web reader API: sık sorulan sorular
Web reader API tarayıcının okuyucu moduyla aynı şey mi?
Aynı fikri izler, makaleyi korur ve karmaşayı atar; ancak bir sunucuda çalışır, Markdown ve metadata'yı JSON olarak döndürür ve binlerce URL için çalışır. Okuyucu modu bir kişinin bir sayfayı okuması içindir.
Web reader API her web sitesini okuyabilir mi?
Hayır. İzin veren genel sayfaları okur. Dikkatli bir hizmet, robots.txt'nin izin vermediği sayfaları atlar ve site reddettiğinde sitenin yanıtını döndürür. Giriş veya ödeme duvarı arkasındaki sayfalar tasarım gereği erişilemez.
Bir web sayfasını Markdown'a dönüştürme aracı görselleri saklar mı?
Genellikle varsayılan olarak hayır, çünkü modeller çoğunlukla metne ihtiyaç duyar. WebReaderAPI ile include_images=true, görselleri alt metinleriyle birlikte Markdown görsel bağlantıları olarak saklar.
Bir sayfayı okumak ne kadar sürer?
Siteye ve sayfanın bir tarayıcıya ihtiyaç duyup duymadığına bağlıdır. Yanıt sürelerini herkese açık bir örnek üzerinde ölçene kadar yayımlamıyoruz; zaman aşımlarınızı 60 saniyeye kadar çıkan timeout parametresine göre planlayın.
WebReaderAPI kullanmak için kimlikli bir hesaba ihtiyacım var mı?
Hayır. WebReaderAPI hiçbir kimlik, selfie veya belge istemez. Girişiniz bir hesap numarasıdır ve ödeme BTC, USDT, USDC, ETH, SOL, LTC ile yapılır.
Kaynaklar (3)
- Markdown for Agents'ı tanıtıyoruz — Cloudflare (2026-02-12)
- Firecrawl fiyatlandırması — Firecrawl (read 2026-10-22)
- Reader API — Jina AI (Elastic) (read 2026-10-22)