DeepSeek Search va Fetch APIlari: AI agentlari uchun jonli veb ma'lumotga kirish

DeepSeek platformasining so'nggi yangilanishi AI agentlari va RAG (retrieval‑augmented generation) ilovalari uchun muhim imkoniyat yaratadi. Yangi Search va Fetch APIlari orqali dasturchilar jonli veb ma'lumotni tez va aniq olishlari mumkin.

Platforma va APIlarning umumiy ko'rinishi

DeepSeek o'zining ichki qidiruv mexanizmini API darajasiga olib chiqdi. DeepSeek Search API hujjatida keltirilganidek, bu ikki xizmat bir xil autentifikatsiya usulini (Bearer token) qo'llaydi va JSON formatida javob beradi.

curl https://api.deepseek.com/v1/tools/search \  -H "Authorization: Bearer <DeepSeek API Key>" \  -H "Content-Type: application/json" \  -d '{    "query": "DeepSeek V4 release",    "count": 5,    "need_content": true  }'

Search API foydalanuvchi so'roviga mos keluvchi veb sahifalarni topadi, Fetch API esa bitta sahifani markdown shaklida qaytaradi. Ikkala xizmat ham RAG arxitekturasi uchun zarur bo'lgan “real‑time” ma'lumotni ta'minlaydi.

import requestsresponse = requests.post(    "https://api.deepseek.com/v1/tools/search",    headers={        "Authorization": "Bearer <DeepSeek API Key>",    },    json={        "query": "DeepSeek V4 release",        "count": 5,        "need_content": True,    },)response.raise_for_status()for result in response.json()["results"]:    print(result["title"], result["url"])    print(result["summary"])

Search API: texnik tafsilotlar

Search API POST https://api.deepseek.com/v1/tools/search endpointiga so'rov yuboradi. Asosiy parametrlar:

{  "query": "DeepSeek site:github.com OR site:huggingface.co lang:en after:2025",  "count": 10}

• query – 1‑128 Unicode belgidan iborat qidiruv so'rovi.
• count – natijalar soni (1‑50, standart 10).
• need_content – true bo'lsa sahifa tarkibi content maydonida qaytariladi.
• ori_question, localization – qo'shimcha kontekst va IP asosida lokalizatsiya.

So'rovda qo'llaniladigan query operatorlari (site:, -site:, lang:, after:, before: va boshqalar) foydalanuvchiga natijalarni aniq filtrlay olish imkonini beradi. Misol uchun DeepSeek site:github.com OR site:huggingface.co lang:en after:2025 so'rovi ingliz tilida, 2025 yildan keyingi GitHub yoki HuggingFace sahifalarini qaytaradi.

{  "results": [    {      "rerank_score": 2.4,      "title": "DeepSeek V4 model released",      "url": "https://example.com/deepseek-v4",      "snippet": "DeepSeek V4 is now available, with tool calling and long-context support.",      "summary": "DeepSeek has released the V4 model. The release adds improved tool calling and long-context support for agent workflows.",      "content": "DeepSeek V4 is now generally available...",      "site_name": "Example News",      "site_icon": "https://example.com/favicon.ico",      "date": "2026-06-01T00:00:00+00:00",      "authority": 3    }  ]}

Fetch API: sahifani markdownga aylantirish

Fetch API POST https://api.deepseek.com/v1/tools/fetch endpointiga URL yuboradi. Birgina parametr – url (maksimal 8192 belgi). Natija JSON obyekti bo'lib, unda title va content (markdown) maydonlari mavjud.

curl https://api.deepseek.com/v1/tools/fetch \  -H "Authorization: Bearer <DeepSeek API Key>" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/article"  }'

Bu API sahifani to'g'ridan-to'g'ri modelga uzatish yoki foydalanuvchi interfeysida ko'rsatish uchun qulay. need_content flagi bilan birgalikda ishlatilganda, bir nechta sahifani bir vaqtning o'zida qidirib, kerakli sahifani fetch qilish jarayoni avtomatlashtiriladi.

import requestsresponse = requests.post(    "https://api.deepseek.com/v1/tools/fetch",    headers={        "Authorization": "Bearer <DeepSeek API Key>",    },    json={"url": "https://example.com/article"},)response.raise_for_status()page = response.json()print(page["title"])print(page["content"])

Natija strukturi va baholash mezonlari

Search API natijalari results massivida quyidagi maydonlarni o'z ichiga oladi:

{  "title": "Example article",  "content": "# Example article\n\nArticle content."}

• rerank_score – 0‑3 oralig'ida aloqadorlik, avtoritet va yangilanish darajasini birlashtiruvchi baho.
• title, url, snippet – foydalanuvchi interfeysi uchun qisqa tavsif.
• summary – modelga o'qish uchun 600‑800 belgili uzun tavsif.
• content – need_content=true bo'lsa sahifa matni.
• authority – sahifaning ishonchlilik darajasi (0‑4, 3+ yuqori).

Bu struktura RAG tizimlarida “retrieval” bosqichini aniq baholash va “generation” bosqichiga yuqori sifatli kontekstni uzatish imkonini beradi.

{  "error": {    "message": "'count' must be between 1 and 50",    "type": "invalid_request_error",    "param": null,    "code": "invalid_request_error"  }}

Raqobatchilar bilan taqqoslash

DeepSeek APIlari Google Custom Search, Bing Search API yoki SerpApi kabi xizmatlarga o'xshash, lekin bir nechta farq bilan ajralib turadi:

• Narx strukturası – DeepSeek $0.75 per 1000 muvaffaqiyatli so'rov, bu ko'pchilik raqobatchilarga nisbatan ancha arzon.
• Rerank_score – natijalarni avtoritet va yangilanishga asoslangan ichki reyting bilan birga beradi, bu esa foydalanuvchi uchun yuqori sifatli natijalarni tanlashni osonlashtiradi.
• Markdown fetch – sahifani to'g'ridan-to'g'ri markdown formatida olish, ko'plab boshqa APIlarda HTML yoki raw text ko'rinishida bo'ladi.

Shu bilan birga, Google va Bing kabi katta qidiruv motorlari global indeksda kengroq qamrovga ega, bu esa ba'zi holatlarda yanada ko'proq natija beradi.

Cheklovlar va ochiq savollar

DeepSeek APIlarida bir nechta texnik cheklovlar mavjud:

• So'rov uzunligi 128 belgidan oshmasligi, bu murakkab filtrlar uchun qo'shimcha kod yozishni talab qiladi.
• Natijalar soni maksimal 50 ga cheklangan, katta hajmdagi ma'lumot to'plamlarini bir necha so'rovga bo'lish kerak.
• Fetch API URL uzunligi 8192 belgidan oshmasligi, ba'zi uzun URLlar uchun qisqartirish kerak bo'ladi.
• Natijalar orasida authority -1 (noma'lum) bo'lishi mumkin, bu esa ishonchlilikni avtomatik baholashni qiyinlashtiradi.

Kelajakda quyidagi savollar hal qilinishi lozim: API qamrovi qanday kengayadi? Rerank algoritmi qanday o'zgaradi? Real‑time limitlar (rate‑limit) qanday boshqariladi?

Kimlarga foyda?

Bu APIlar asosan quyidagi foydalanuvchilarga mo'ljallangan:

• AI agent ishlab chiquvchilari – agentlar real‑time ma'lumotga asoslanib qaror qabul qilishlari mumkin.
• RAG ilova yaratuvchilari – ma'lumotni qidirish va sahifani markdownda olish orqali kontekstni modelga uzatish soddalashadi.
• Data analystlar – tezkor veb ma'lumotlarni yig'ish va tahlil qilish uchun APIlarni skriptlarda ishlatish.
• Kontent aggregatörlari – yangiliklar, texnik maqolalar yoki kod snippetlarini avtomatik tarzda to'plash.

Arzon narx va oddiy autentifikatsiya (Bearer token) bu xizmatni kichik startaplar ham, katta korporativ loyihalar ham qo'llashga imkon beradi.

Xulosa

DeepSeek Search va Fetch APIlari AI agentlari va RAG tizimlari uchun jonli veb ma'lumotga kirishni soddalashtiradi. Qidiruv operatorlari, rerank baholash va markdown fetch kabi funksiyalar foydalanuvchi tajribasini oshiradi. Narxning raqobatbardoshligi va texnik hujjatlarning aniq tuzilishi bu xizmatni keng qo'llashga undaydi, lekin so'rov uzunligi, natija soni va avtoritet bahosi kabi cheklovlar ham e'tiborga olinishi kerak. Kelajakda API qamrovini kengaytirish va limitlarni yumshatish platformaning yanada jozibador bo'lishini ta'minlaydi.

Asl manba: api-docs.deepseek.com