DeepSeek avasi 17. lokakuuta 2026 kehittäjille erilliset Search- ja Fetch-rajapinnat agentteja ja RAG-sovelluksia varten. RAG eli tiedonhakuun perustuva generointi tarkoittaa, että sovellus hakee ulkoista aineistoa ja käyttää sitä vastauksen tuottamiseen. Search etsii ajantasaisia verkkosivuja DeepSeekin omalla hakukoneella, ja Fetch noutaa annetun sivun Markdown-muotoisena.
14
23
24
Päätepisteet ja tunnistautuminen
Molemmat rajapinnat käyttävät osoitetta https://api.deepseek.com, palauttavat raakaa JSON-dataa ja käyttävät samaa Bearer-tunnistautumista kuin DeepSeekin API.
23
- Search:
POST https://api.deepseek.com/v1/tools/search
- Fetch:
POST https://api.deepseek.com/v1/tools/fetch
Search: kyselyt ja hakutulokset
Search vaatii query-kenttään ei-tyhjän kyselyn, jonka pituus on 1–128 Unicode-merkkiä. Valinnainen count määrittää tulosten määrän: oletusarvo on 10, ja sallitut arvot ovat 1–50. Dokumentaatiossa mainitaan lisäksi valinnaiset kentät ori_question, localization ja need_content. Integraatioviitteen mukaan need_content-kentän oletusarvo on false. Saatavilla olevat lähteet eivät kuitenkaan määrittele tarkasti kaikkien valinnaisten kenttien merkitystä tai odotettua muotoa.
17
36
Virallinen API-viite kertoo, että haussa voi käyttää operaattoreita site: ja -site: sekä lainausmerkkeihin merkittyjä fraaseja. Integraatioviitteessä luetellaan myös operaattorit -term, lang:, after: ja before:. Tätä lisälistaa kannattaa pitää integraatio-ohjeena, ei täydellisenä takeena rajapinnan toiminnasta.
17
34
Search palauttaa järjestetyn joukon rakenteisia tuloksia. Yhteisön ylläpitämä integraatioviite luettelee kentiksi muun muassa title, url, snippet ja summary sekä pyydettäessä content-kentän. Lisäksi siinä mainitaan date, rerank_score ja authority. Viitteen mukaan katkelmat ovat tyypillisesti 100–200 merkkiä ja yhteenvedot 600–800 merkkiä. Koska nämä kenttä- ja pituustiedot perustuvat integraatioviitteeseen eivätkä virallisen API-viitteen otteeseen, tarkista nykyinen vastausskeema ennen kuin rakennat toteutuksen niiden varaan.
36
Fetch: URL-osoitteesta Markdown-sivuksi
Fetch vaatii URL-osoitteen, jonka pituus voi olla enintään 8 192 merkkiä. API-viitteen mukaan osoitteen on käytettävä HTTP- tai HTTPS-protokollaa ja sisällettävä palvelinnimi. Käyttäjätunnusta tai salasanaa sisältäviä osoitteita ei hyväksytä. Vastauksessa palautetaan sivun otsikko ja sisältö Markdown-muodossa.
18
Dokumentaatio ei takaa, että jokainen sivusto on saavutettavissa, eikä se määrittele kaikkia sisällön poimintaan liittyviä rajoituksia tai virhetilanteita. Fetchin ei siis pidä olettaa palauttavan täydellistä sisältöä jokaisesta annetusta osoitteesta.
18
Hinta ja väliaikainen maksuttomuus
DeepSeek ilmoitti kummankin päätepisteen hinnaksi 0,75 dollaria tuhatta pyyntöä kohden. Julkaistujen tietojen mukaan veloitus koskee onnistuneita pyyntöjä; epäonnistuneista pyynnöistä, tyhjistä tuloksista ja aikakatkaisuista ei veloiteta. Integraatioviitteessä haun ja noudon kulut kuvataan erillisiksi mallin token-kuluista, joten rajapintamaksu ei kata haetun sisällön käsittelyyn mahdollisesti tarvittavaa mallikäyttöä.
2
13
24
Julkaisuhetkellä Search- ja Fetch-kutsut olivat DeepSeek API -käyttäjille väliaikaisesti maksuttomia, kun niitä tehtiin palvelinpuolen työkaluilla DeepSeek Harnessissa, Claude Codessa tai Codexissa. Maksullisen laskutuksen ilmoitettiin alkavan 31. lokakuuta 2026 kello 16.00 UTC, eli 1. marraskuuta kello 00.00 Pekingin aikaa. Poikkeus koskee näitä työkaluintegraatioita, eikä sitä pidä tulkita suorien API-kutsujen yleiseksi maksuvapaudeksi.
2
24
Pyyntörajoitukset ja avoimet kysymykset
Toissijaisissa lähteissä Search- ja Fetch-rajapinnoille ilmoitetaan rajaksi 5 pyyntöä sekunnissa tiliä kohden.
4
10 Saatavilla olevat dokumentit eivät kerro, ovatko rajat erilliset kummallekin päätepisteelle, valvotaanko niitä tilin vai API-avaimen perusteella, onko Fetchillä lisäksi verkkotunnuskohtaisia rajoja tai miten rajanylitykseen vastataan.
17
18
DeepSeekin erillisessä rajoitusdokumentaatiossa käsitellään mallien samanaikaisia pyyntöjä, mutta käytettävissä oleva ote ei selitä, miten nämä rajat liittyvät Search- ja Fetch-liikenteeseen. Se ei myöskään vahvista, että Search- tai Fetch-rajan ylittyminen palauttaisi aina HTTP 429 -vastauksen.
25
Julkaisu vahvisti rajapintojen perustoiminnot, DeepSeekin oman hakukoneen käytön ja pyyntökohtaisen hinnoittelun. Tarkista ajantasaisista API-viitteistä yksityiskohdat, joita dokumentoidut parametrit ja URL-vaatimukset eivät kata — erityisesti valinnaisten kenttien muodot, koko vastausskeema ja poikkeustilanteiden toiminta. Kolmansien osapuolten integraatio-ohjeita ei kannata pitää palvelun virallisena sopimuksena.
17
18
23