search_web
Carian web berprogram dikuasakan oleh Google Custom Search API dengan penapisan lanjutan, kedudukan dan metadata hasil. Sesuai untuk mengautomasikan penyelidikan dan penemuan kandungan.
Kes Penggunaan
Automasi Penyelidikan
Automasikan penyelidikan dengan mencari kertas akademik, artikel berita atau dokumentasi teknikal
Penemuan Kandungan
Cari kandungan, blog atau sumber yang relevan untuk penciptaan dan kurasi kandungan
Pemantauan Persaingan
Jejaki sebutan jenama, produk atau pesaing anda di seluruh web
Penjanaan Prospek
Cari bakal pelanggan, rakan kongsi atau peluang berdasarkan kriteria carian
Penyelidikan SEO
Analisis hasil carian untuk memahami faktor kedudukan dan strategi pesaing
Pengumpulan Data
Kumpulkan URL untuk scraping atau analisis lanjut berdasarkan pertanyaan carian
Endpoint
/api/v1/tools/search_webParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Required | - | Pertanyaan carian (menyokong operator lanjutan) Example: best web scraping tools 2025 |
limit | number | Optional | 10 | Bilangan hasil untuk dikembalikan (1-100) Example: 25 |
timeRange | string | Optional | - | Tapis mengikut tarikh terbit: day, week, month, year, atau custom Example: month |
safeSearch | boolean | Optional | true | Tapis kandungan eksplisit Example: true |
site | string | Optional | - | Hadkan carian kepada tapak atau domain tertentu Example: github.com |
fileType | string | Optional | - | Tapis mengikut jenis fail: pdf, doc, xls, ppt, dll. Example: pdf |
language | string | Optional | en | Kod bahasa (ISO 639-1) Example: en |
country | string | Optional | - | Kod negara untuk hasil khusus geografi (ISO 3166-1) Example: us |
Contoh Permintaan
Contoh Respons
{ "success": true, "data": { "query": "best web scraping tools 2025", "totalResults": 12500000, "resultsReturned": 25, "results": [ { "position": 1, "title": "Top 10 Web Scraping Tools for 2025 - Developer Guide", "url": "https://example.com/scraping-tools", "displayUrl": "example.com › scraping-tools", "snippet": "Discover the best web scraping tools in 2025 including CrawlForge MCP, Beautiful Soup, and Scrapy. Compare features, pricing, and use cases...", "date": "2025-09-15", "domain": "example.com", "favicon": "https://example.com/favicon.ico" }, { "position": 2, "title": "CrawlForge MCP: The Ultimate Web Scraping Solution", "url": "https://crawlforge.dev", "displayUrl": "crawlforge.dev", "snippet": "CrawlForge MCP offers 23 powerful web scraping tools in one API. Start with 1,000 free credits and automate your data extraction...", "date": "2025-09-28", "domain": "crawlforge.dev", "favicon": "https://crawlforge.dev/favicon.ico" } ], "searchMetadata": { "searchTime": 0.45, "language": "en", "country": "us", "safeSearch": true, "timeRange": "month" } }, "credits_used": 5, "credits_remaining": 995, "processing_time": 1250}data.totalResultsJumlah hasil yang tersedia (tidak semua dikembalikan)data.resultsReturnedBilangan hasil dalam respons inidata.resultsTatasusunan hasil carian dengan metadatadata.results[].snippetPetikan deskriptif daripada halamandata.results[].dateTarikh terbitan jika tersediacredits_used5 credits tetap setiap pertanyaan carianprocessing_timeCarian biasanya selesai dalam 1-2 saatPengendalian Ralat
Pertanyaan Kosong (400 Bad Request)
Pertanyaan carian tidak boleh kosong. Sediakan sekurang-kurangnya 2 aksara.
Tiada Hasil Ditemui (404 Not Found)
Tiada hasil carian sepadan dengan pertanyaan anda. Cuba istilah carian yang lebih luas atau buang penapis.
Parameter Tidak Sah (400 Bad Request)
Semak parameter timeRange, language atau country untuk nilai yang sah.
Kuota Melebihi Had (429 Too Many Requests)
API carian mempunyai had harian. Naik taraf pelan anda untuk kuota lebih tinggi.
Kos Credit
Apa yang Disertakan:
Sehingga 100 hasil setiap carian
Penapisan lanjutan (masa, tapak, jenis fail)
Sokongan pelbagai bahasa dan negara
Penapisan carian selamat
Metadata hasil (tarikh, domain, petikan)
Cadangan Pelan:
Pelan Free: 1,000 credits percubaan sekali sahaja = 200 carian
Pelan Hobby: 5,000 credits = 1,000 carian ($19/mo)
Pelan Professional: 50,000 credits = 10,000 carian ($99/mo)