Jawaban singkat: DeepSeek Search API gratis hanya di dalam tiga alat coding, dan hanya sampai 31 Oktober 2026 pukul 16:00 UTC. Panggilan Search dan Fetch yang dilakukan Claude Code, Codex, atau DeepSeek Harness di sisi server tidak dikenakan biaya sampai saat itu. Setelahnya, dan untuk setiap panggilan langsung ke endpoint, Anda membayar $0,75 per 1.000 permintaan yang berhasil per endpoint. Panggilan yang gagal, hasil kosong, dan timeout tidak pernah dikenakan biaya.
DeepSeek membuka Search dan Fetch API-nya untuk semua orang pada 17 Oktober 2026, bersamaan dengan rilis DeepSeek-V4.1-Flash-1017. API ini memberi agen hasil web yang segar untuk sebuah kueri dan salinan Markdown yang bersih dari halaman mana pun. Panduan ini membahas apa yang gratis, berapa biayanya setelah periode tersebut, batas laju, permintaan pertama, dan pengujian kedua endpoint dengan Apidog CLI.
Setiap fakta di bawah ini berasal dari panduan Search & Fetch DeepSeek dan halaman harga, yang dibaca pada 28 Oktober 2026.
Apakah DeepSeek Search API gratis?
Ya, dengan dua batasan: dari mana Anda memanggilnya, dan kapan. Dokumen DeepSeek menyatakan panggilan Search dan Fetch di sisi server yang dilakukan melalui DeepSeek Harness, Claude Code, atau Codex "saat ini gratis." Penagihan per permintaan untuk panggilan tersebut dimulai pada pukul 00:00 tanggal 1 November 2026 waktu UTC+8, yaitu 16:00 UTC pada 31 Oktober 2026.
| Jalur | Biaya Search dan Fetch sebelum 31 Okt, 16:00 UTC | Setelahnya |
|---|---|---|
| Claude Code dengan kunci API DeepSeek | $0 | $0,75 / 1.000 panggilan berhasil |
| Codex dengan kunci API DeepSeek | $0 | $0,75 / 1.000 panggilan berhasil |
| DeepSeek Harness | $0 | $0,75 / 1.000 panggilan berhasil |
POST langsung ke /v1/tools/search atau /v1/tools/fetch |
$0,75 / 1.000 panggilan berhasil | $0,75 / 1.000 panggilan berhasil |
Ada dua hal yang membuat ini bukan jalur nol dolar sepenuhnya:
- Anda tetap memerlukan kunci API DeepSeek yang sudah diisi saldo. Periode gratis ini mencakup panggilan pencarian, bukan modelnya. Halaman integrasi Claude Code DeepSeek menyatakan bahwa merangkum hasil pencarian menggunakan permintaan LLM tambahan, dan token tersebut ditagih dengan harga model normal.
- Periode ini hanya mencakup panggilan alat di sisi server. Dokumen membatasinya pada tiga alat tersebut. Jika kode Anda sendiri yang memanggil endpoint, Anda membayar sejak permintaan pertama yang berhasil.
Jika Anda mencari model DeepSeek gratis alih-alih pencarian gratis, panduan kami tentang apakah DeepSeek gratis mencantumkan setiap jalurnya, dan kunci API DeepSeek gratis membahas kuncinya sendiri.
Apa yang dilakukan DeepSeek Search dan Fetch API
DeepSeek Search API menerima kueri dan mengembalikan hasil web terstruktur: judul, URL, cuplikan, ringkasan yang lebih panjang berorientasi model, kolom konten halaman penuh opsional, skor relevansi, dan skor otoritas. DeepSeek Fetch API menerima satu URL dan mengembalikan judul halaman tersebut beserta kontennya dalam format Markdown. Bersama-sama, keduanya memberi agen kemampuan mencari plus membaca dalam dua panggilan.
Agen riset biasanya mencari sekali, lalu mengambil dua atau tiga halaman, dan masing-masing merupakan panggilan berbayar terpisah setelah periode gratis berakhir. Search mendukung operator: site:, -site:, "phrase", -term, lang:en,ja, after:, dan before:.
Anda dapat membandingkannya dengan opsi lain di kumpulan kami tentang API pencarian web gratis, Claude web search API, dan Perplexity Search API.
Harga DeepSeek Search API setelah periode gratis
Setelah periode tersebut berakhir, kedua endpoint menagih dengan cara yang sama:
| Search API | Fetch API | |
|---|---|---|
| Harga | $0,75 per 1.000 permintaan berhasil | $0,75 per 1.000 permintaan berhasil |
| Per panggilan | $0,00075 | $0,00075 |
| Ditagih saat | HTTP 200 dengan array results tidak kosong |
HTTP 200 dengan konten halaman |
| Tidak ditagih | Permintaan gagal, hasil kosong, timeout | Permintaan gagal, timeout |
Apakah count mengubah harga? |
Tidak | Tidak berlaku |

Biaya diambil dari saldo DeepSeek Anda, dan halaman harga menyatakan saldo yang diberikan digunakan sebelum saldo yang diisi ulang ketika Anda memiliki keduanya.
Sedikit perhitungan untuk agen riset yang menjalankan 200 tugas sehari, masing-masing dengan satu pencarian dan tiga pengambilan:
- 200 pencarian x $0,00075 = $0,15
- 600 pengambilan x $0,00075 = $0,45
- Total: $0,60 sehari, sekitar $18 sebulan, sebelum token model
Karena count tidak mengubah harga, mintalah hingga 50 hasil dalam satu panggilan alih-alih melakukan paging. Untuk sisi model, deepseek-flash berbiaya $0,15 per juta token input (cache miss, off-peak) dan $0,60 per juta output, dua kali lipat pada jam sibuk; lihat harga DeepSeek V4.1 Flash.
Batas laju DeepSeek Search API
Beberapa tulisan pihak ketiga menyebut batas 5 QPS. Panduan resmi DeepSeek memberikan angka yang berbeda, dan itulah yang harus Anda jadikan acuan:
- Search: 100 kueri per detik
- Fetch: 25 kueri per detik, ditambah batas per domain yang nilainya tidak dipublikasikan
Batas berlaku per akun, berlaku di semua kunci API Anda, dan terpisah dari konkurensi model. Search dan Fetch diukur secara independen, jadi lonjakan pengambilan tidak akan memakan anggaran pencarian Anda. Melebihi batas akan mengembalikan HTTP 429.

Perhatikan batas Fetch per domain: agen yang mengambil 20 halaman dari satu situs dokumen dapat mencapainya jauh di bawah 25 QPS. Beri jarak antar pengambilan dari domain yang sama dan coba ulang 429 dengan backoff.
Endpoint dan panggilan DeepSeek Search API pertama Anda
Kedua endpoint menggunakan POST, menggunakan bearer token, dan menerima JSON:
- Search:
https://api.deepseek.com/v1/tools/search - Fetch:
https://api.deepseek.com/v1/tools/fetch
Kolom permintaan Search
| Kolom | Tipe | Wajib | Bawaan | Catatan |
|---|---|---|---|---|
query |
string | Ya | tidak ada | 1 hingga 128 karakter, operator diizinkan |
count |
integer | Tidak | 10 | 1 hingga 50 |
ori_question |
string | Tidak | tidak ada | Pertanyaan asli pengguna, 1 hingga 128 karakter |
localization |
string | Tidak | "" |
Alamat IP untuk melokalkan hasil |
need_content |
boolean | Tidak | false | Jika false, content tetap kosong |
Permintaan pencarian, diambil dari dokumen:
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}'

Setiap item dalam array results memuat title, url, snippet, summary, content, site_name, site_icon, date (RFC 3339 UTC atau null), rerank_score, dan authority. Filter berdasarkan dua di antaranya sebelum Anda melakukan pengambilan:
rerank_scoreberkisar dari 0 hingga 3. DeepSeek menganggap 1,5 atau lebih sebagai kualitas tinggi.authorityberkisar dari 0 hingga 4, dengan -1 untuk tidak diketahui. 3 atau lebih berarti sumber yang sangat otoritatif.
Permintaan fetch mengambil satu kolom, url (HTTP atau HTTPS, hingga 8.192 karakter, tanpa nama pengguna atau kata sandi tersemat):
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"}'
API ini mengembalikan title (yang mungkin kosong) dan content dalam format Markdown.
Error yang akan Anda temui
| Kode | Arti | Coba ulang? |
|---|---|---|
| 400 | Header, body, atau nilai kolom tidak valid | Perbaiki permintaan terlebih dahulu |
| 401 | Kunci hilang atau tidak valid | Tidak |
| 402 | Saldo tidak cukup | Isi ulang, lalu coba lagi |
| 403 | Fetch diblokir oleh kebijakan keamanan | Tidak |
| 404 | Fetch tidak bisa mendapatkan konten yang dapat digunakan | Tidak |
| 408 / 429 / 5xx | Timeout, batas laju, error server | Ya, setelah menunggu |
Body error mengikuti bentuk OpenAI: message, type, param (selalu null), dan code.
Menggunakan Search dari Claude Code atau Codex vs memanggilnya secara langsung
Periode gratis hanya berlaku ketika alat coding yang melakukan panggilan untuk Anda, jadi pengaturannya yang menentukan tagihannya.
Claude Code. Arahkan Claude Code ke endpoint kompatibel Anthropic milik DeepSeek dan API DeepSeek akan menjalankan alat Web Search di sisi server. Variabel inti dari halaman DeepSeek:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
Salin seluruh blok, yang menetapkan beberapa variabel model lainnya, dari halaman DeepSeek.

Codex. Pencarian web bawaan Codex hanya berfungsi dengan deepseek-v4-pro, menurut halaman integrasi Codex DeepSeek. Skrip penyiapan mematikan pencarian web secara bawaan, jadi tetapkan dua baris ini di ~/.codex/config.toml dan mulai ulang:
model = "deepseek-v4-pro"
web_search = "live"

Konsekuensinya: deepseek-v4-pro berbiaya lebih tinggi per token daripada deepseek-flash.
Panggilan langsung. Panggil endpoint sendiri ketika Anda sedang membangun agen Anda sendiri atau ingin mengendalikan count, need_content, dan operator. Anda membayar sejak panggilan pertama yang berhasil. Jika Anda hanya ingin agen yang mencari informasi saat sedang coding, gunakan Claude Code atau Codex selama periode gratis.
Biarkan agen coding Anda menguji DeepSeek Search API dengan Apidog CLI
Sebelum Anda menghubungkan Search dan Fetch ke dalam sebuah produk, buktikan bahwa autentikasi, bentuk respons, dan error berperilaku sesuai dokumentasi. Agen coding Anda dapat membangun dan menjalankan pemeriksaan tersebut dengan Apidog CLI, sehingga pengujiannya berada dalam proyek yang dapat dijalankan ulang oleh tim Anda di CI.
Siapkan sekali:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Lalu berikan satu prompt kepada Claude Code, Codex, atau agen apa pun yang Anda gunakan:
In Apidog project <projectId>, add the DeepSeek endpoints POST /v1/tools/search
and POST /v1/tools/fetch with base URL https://api.deepseek.com and bearer auth
from the DEEPSEEK_API_KEY variable. Create test cases that assert: search returns
200 with a results array whose rerank_score values are between 0 and 3; fetch on
https://example.com returns 200 with non-empty content; a bad key returns 401.
Run them against the deepseek environment and summarize any failures.
Agen membaca setiap skema payload, memvalidasi JSON-nya, lalu menulis dan menjalankan pengujian:
apidog environment create deepseek --project <projectId> --base-url https://api.deepseek.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file search-endpoint.json
apidog endpoint create --project <projectId> --file search-endpoint.json
apidog cli-schema get test-case-create
apidog test-case create --project <projectId> --file search-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
Setiap eksekusi penuh melakukan dua panggilan berbayar setelah periode gratis (satu pencarian, satu pengambilan), sehingga biayanya $0,0015. Pemeriksaan 401 tidak dikenakan biaya karena permintaan yang gagal tidak ditagih. Baris apidog run ... -r junit yang sama dapat dimasukkan ke dalam pipeline, seperti yang ditunjukkan dalam menjalankan Apidog CLI di CI/CD. Jika Claude Code adalah agen Anda, Apidog CLI di Claude Code membahas pemasangan skill-nya.
Paket Free Apidog mencakup hingga 4 pengguna, sehingga tim kecil dapat berbagi proyek dan riwayat pengujiannya.
FAQ
Apakah DeepSeek Search API gratis setelah 31 Oktober? Tidak. Mulai 16:00 UTC pada 31 Oktober 2026, panggilan Search dan Fetch melalui Claude Code, Codex, dan DeepSeek Harness berbiaya $0,75 per 1.000 permintaan yang berhasil, sama seperti panggilan langsung.
Apakah DeepSeek Fetch API gratis? Hanya dengan syarat yang sama seperti Search: gratis ketika Claude Code, Codex, atau DeepSeek Harness memanggilnya di sisi server sebelum batas waktu, lalu $0,75 per 1.000 permintaan yang berhasil.
Apakah saya memerlukan kunci API DeepSeek untuk menggunakan pencarian gratis di Claude Code? Ya. Claude Code harus dijalankan dengan kunci API DeepSeek melalui https://api.deepseek.com/anthropic, dan token model yang dihabiskan untuk merangkum hasil ditagih secara normal.
Berapa batas laju DeepSeek Search API? Panduan DeepSeek mencantumkan 100 QPS untuk Search dan 25 QPS untuk Fetch per akun, ditambah batas per domain pada Fetch yang tidak dipublikasikan. Melebihi batas tersebut akan mengembalikan HTTP 429.
Apakah saya dikenakan biaya ketika pencarian tidak mengembalikan apa pun? Tidak. Hasil kosong, permintaan gagal, dan timeout tidak ditagih. Search hanya menagih pada HTTP 200 dengan array results yang tidak kosong.
Apakah meminta lebih banyak hasil membuat biaya lebih mahal? Tidak. Kolom count (1 hingga 50) tidak mengubah harga, jadi satu pencarian dengan 50 hasil berbiaya sama dengan pencarian dengan 5 hasil.
