Kısa yanıt
URL'lerine zaten sahip olduğum web sayfalarını nasıl okurum?
En fazla 20 URL'yi POST https://llmwebsearch.com/api/v1/extract adresine gönderin. LLMWebSearch her genel sayfayı okur ve ana içeriğini Markdown veya düz metin olarak, URL başına bir durumla döndürür. Faturalandırma, okunan her başlatılan 3 sayfa grubu için 1 kredidir; Ekim 2026 itibarıyla arama kredisi başına $1,20/1K arama'den başlar. robots.txt'ye saygı gösterilir. KYC yok; kripto ile ödeyin.
/extract at a glance
| Yöntem | POST ile JSON gövdesi |
|---|---|
| URL | https://llmwebsearch.com/api/v1/extract |
| Girdi | urls: 1 ila 20 http veya https adresi |
| Çıktı | URL başına ana içerik, markdown (varsayılan) veya text olarak |
| Faturalama | URL'sini zaten bildiğiniz sayfaları okumak, içerikle birlikte döndürülen her başlamış 3 sayfalık grup için 1 kredi eder, çağrı başına en fazla 20 URL; reddedilen veya başarısız olan URL'ler sayılmaz |
| robots.txt | Okuyucumuz robots.txt'ye uyar: kendini LLMWebSearch olarak tanıtır, bir sitenin onun için ya da tüm robotlar için yazdığı kurallara uyar ve okumasına izin verilmeyen her sayfanın içeriğini dışarıda bırakır |
| Sayfa okuyucusu | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/) |
URL listesini oku
POST/api/v1/extract
Her URL'yi paralel olarak getirir ve ana içeriğini gönderdiğiniz sırayla döndürür. Her öğenin kendi content_status değeri vardır, böylece reddedilen bir sayfa çağrıyı başarısız kılmaz. Örnek üç sayfa okur; başlıklar ve değerler örnektir.
Kimlik doğrulama: Authorization: Bearer API_KEY başlığında API anahtarı.
İstek gövdesi
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
urls | string[] | Evet | 1 ila 20 http veya https adresi. Özel, yerel ve bulut metadata adresleri reddedilir. |
format | string | Hayır | markdown (varsayılan) veya text. |
max_chars | integer | Hayır | Her sayfanın içeriğinin uzunluk sınırı, 500 ila 50.000 karakter. Varsayılan 6.000. |
{
"urls": [
"https://docs.example.com/security/key-rotation",
"https://blog.example.org/key-rotation-checklist",
"https://example.com/changelog"
],
"max_chars": 20000
}Yanıt 200
{
"credits_used": 1,
"results": [
{
"url": "https://docs.example.com/security/key-rotation",
"title": "Rotating API keys",
"content_status": "ok",
"content": "# Rotating API keys\n\n## Zero-downtime rotation\n\n1. Create a second key...",
"word_count": 948
},
{
"url": "https://blog.example.org/key-rotation-checklist",
"content_status": "blocked_by_robots"
},
{
"url": "https://example.com/changelog",
"title": "Changelog",
"content_status": "ok",
"content": "# Changelog\n\n## 2026-10-20\n\n- New export format...",
"word_count": 2204
}
]
}Kod örnekleri
curl -s "https://llmwebsearch.com/api/v1/extract" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://docs.example.com/security/key-rotation", "https://example.com/changelog"], "max_chars": 20000}'import os
import requests
resp = requests.post(
"https://llmwebsearch.com/api/v1/extract",
headers={"Authorization": "Bearer " + os.environ["LLMWEBSEARCH_API_KEY"]},
json={"urls": ["https://docs.example.com/security/key-rotation", "https://example.com/changelog"]},
timeout=60,
)
for page in resp.json()["results"]:
print(page["url"], page["content_status"], page.get("word_count", 0))const res = await fetch('https://llmwebsearch.com/api/v1/extract', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.LLMWEBSEARCH_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ urls: ['https://docs.example.com/security/key-rotation', 'https://example.com/changelog'] }),
});
for (const page of (await res.json()).results) console.log(page.url, page.content_status);Bir aramada read yerine extract'i ne zaman kullanmalıyım?
URL'ler çalıştırdığınız aramadan gelmiyorsa extract kullanın. Bir kullanıcı bir bağlantı yapıştırır, bir belge üç kaynağa atıfta bulunur veya read=0 ile yapılan ilk arama, modelin hangi sayfaların tam okunmayı hak ettiğini seçmesine izin verir.
Sadece en iyi sonuçların aynı çağrıda okunmasını istiyorsanız /search içinde read kullanın. İki istek yerine tek istektir ve 3 sayfaya kadar aramanın tek kredisine dahildir.
Extract çağrıları nasıl faturalandırılır?
Okunan her başlatılan 3 sayfa grubu için bir kredi. Sayım, içerikle dönen sayfaları kullanır: robots.txt veya site tarafından reddedilen ya da yüklenemeyen bir URL sayılmaz.
| Okunan sayfalar | Krediler |
|---|---|
| 1 ila 3 | 1 |
| 4 ila 6 | 2 |
| 7 ila 9 | 3 |
| 19 veya 20 | 7 |
Yanıt her zaman toplamı credits_used içinde belirtir. Hiçbir sayfanın okunamadığı bir çağrı ücretsizdir.
Yanıtın her öğesi bana ne söyler?
Her öğe, gönderdiğiniz url öğesini yineler ve bir content_status döndürür. ok ile ayrıca sayfayı title, ana content ve word_count alırsınız. Aksi halde durum kodu nedeni belirtir: blocked_by_robots, blocked_by_site_policy, target_refused ile sitenin target_status, fetch_failed, fetch_timeout veya unsupported_content.
Öğeler, urls listenizin sırasını korur; böylece bunları hem indeksle hem de URL ile eşleştirebilirsiniz. Yanıt formatı sayfası her durum kodunu açıklar.
Hangi URL'ler herhangi bir getirme işleminden önce reddedilir?
Özel ağlara, yerel makineye veya bulut metadata servislerine işaret eden adresler reddedilir. Bu, kimsenin reader'ımızı dahili sistemlere ulaşmak için kullanmasını önler. Böyle bir adrese yönlendiren bir redirect de reddedilir ve en fazla 5 redirect izlenir.
Adres http veya https kullanmalıdır. urls boş olan, 20'den fazla giriş içeren veya hatalı biçimlendirilmiş bir adres içeren bir çağrı, ücretsiz olarak 400 invalid_parameter döndürür.
Extract, search ile aynı kurallara uyar mı?
Evet. Aynı reader'dır ve kendini LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/) olarak tanıtır. robots.txt dosyasında Content-Signal: ai-input=no ayarlayan bir site, sayfalarını sonuçlarınızın içeriğinden uzak tutar. Bir site okuyucumuzu geri çevirdiğinde sonuç, içerik olmadan ve sitenin durumuyla döner: CAPTCHA'ları asla çözmeyiz, hesaplara giriş yapmayız veya bir engeli ya da ödeme duvarını aşmaya çalışmayız.
Giriş gerektiren veya ödeme duvarı arkasındaki sayfalar içerik olmadan döner. Agent'ı başka bir kaynağa veya kendi tarayıcı oturumunuzla okumanıza izin verilen bir sayfaya yönlendirin.
Extract endpoint: sık sorulan sorular
Hangi tür dosyaları okuyabilir?
Web sayfaları bunun için tasarlanmıştır. Bir videoya, arşive veya okunabilir metni olmayan başka bir dosyaya verilen bağlantı unsupported_content olarak döner ve o URL fiyata dahil edilmez.
İki kez gönderilen bir URL iki kez mi okunur?
Her URL'yi bir kez gönderin. Bir listede yinelenenler olabilecekse, sonuçların listenizle bire bir eşleşmesi için önce kendi tarafınızda bunları kaldırın.
JavaScript rendering ek ücretli mi?
Hayır. Bir sayfa metnini göstermek için tarayıcı gerektirdiğinde, ek maliyet olmadan render edilir.
Extract, giriş yaptığım bir sayfayı okuyabilir mi?
Hayır. Reader hiçbir zaman hesaplara giriş yapmaz ve sizin cookie'lerinizi göndermez. Bir site okuyucumuzu geri çevirdiğinde sonuç, içerik olmadan ve sitenin durumuyla döner: CAPTCHA'ları asla çözmeyiz, hesaplara giriş yapmayız veya bir engeli ya da ödeme duvarını aşmaya çalışmayız.