CarianGoogle API5 credits

search_web

Indeks Google, sebagai JSON. Setiap hasil membawa tajuk, URL, cebisan dan varian bersorot milik Google sendiri, di samping blok metadata dengan jumlah padanan dan tempoh carian itu. Penapis untuk tapak, jenis fail, bahasa, kebaruan dan carian selamat digunakan sebagai operator Google yang sebenar.

Kes Penggunaan

Saluran Penyelidikan

Cari sumber bagi sesuatu topik, kemudian suapkan URL itu terus ke batch_scrape atau extract_content.

Carian Terhad kepada Tapak

Tetapkan site untuk mencari dalam satu domain — pengganti kotak carian tapak yang tidak wujud atau berfungsi dengan buruk.

Pemburuan Dokumen

Gabungkan file_type dengan pertanyaan untuk mencari PDF, hamparan atau dek slaid tentang sesuatu subjek.

Pemantauan Kebaruan

Hadkan kepada hari atau minggu lepas dengan time_range untuk menangkap liputan baharu tentang sesuatu topik atau jenama.

Penemuan Persaingan

Lihat halaman yang ditonjolkan Google bagi istilah yang anda pentingkan, dan berapa banyak hasil yang wujud secara keseluruhan.

Pengukuhan Ejen

Berikan model hasil carian semasa untuk digunakan, dan bukannya bergantung pada apa yang dihafalnya.

Endpoint

POST/api/v1/tools/search_web

Auth Required

1 req/s pada pelan Free

5 credits

Parameters

limit menerima sehingga 100, tetapi Google mengembalikan paling banyak 10 hasil setiap permintaan — limit yang lebih besar tidak gagal, ia hanya memberi anda 10. Halusuri selebihnya dengan offset, satu carian (dan 5 credits) setiap halaman.

Name	Type	Required	Default	Description
query	string	Required	-	Istilah carian. Operator Google yang anda taip di sini berfungsi seperti dalam kotak carian, dan `site` serta `file_type` ditambah sebagai operator di atasnya. Example: mcp server for web scraping
limit	number	Optional	10	Hasil untuk dikembalikan, 1-100 — tetapi Google mengehadkan satu permintaan kepada 10, jadi apa-apa melebihi 10 berkelakuan sebagai 10. Example: 10
offset	number	Optional	0	Indeks berasaskan sifar bagi hasil pertama. Gunakan 10, 20, 30 untuk berhalaman. Setiap halaman ialah carian berasingan dan berharga 5 credits. Example: 10
lang	string	Optional	-	Hadkan kepada dokumen dalam satu bahasa, sebagai kod ISO 639-1. Dikembalikan dalam `search_metadata.lang`, yang lalai kepada `en` apabila anda meninggalkannya. Example: es
site	string	Optional	-	Hadkan kepada satu domain. Ditambah pada pertanyaan anda sebagai `site:<domain>`, jadi ia berkelakuan sama seperti menaipnya. Example: docs.anthropic.com
safe_search	boolean	Optional	-	Hidupkan penapisan SafeSearch Google. Dimatikan melainkan anda menetapkannya. Example: true
time_range	string	Optional	-	Hadkan mengikut kebaruan: `day`, `week`, `month`, `year` atau `all`. `all` tidak mengenakan sekatan, dan ia juga nilai lalai. Example: week
file_type	string	Optional	-	Hadkan kepada satu sambungan fail. Ditambah sebagai `filetype:<ext>`, jadi `pdf`, `xlsx` dan `pptx` semuanya berfungsi. Example: pdf

Contoh Permintaan

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/search_web \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mcp server for web scraping",
    "limit": 10,
    "time_range": "month",
    "safe_search": true
  }'

Contoh Respons

200 OK460ms

{
  "success": true,
  "data": {
    "query": "mcp server for web scraping",
    "search_metadata": {
      "total_results": 48200,
      "results_returned": 1,
      "offset": 0,
      "search_time": 0.312,
      "lang": "en",
      "safe_search": false,
      "time_range": "month",
      "site": null,
      "file_type": null
    },
    "results": [
      {
        "title": "CrawlForge MCP Server — 29 web tools for Claude",
        "url": "https://www.crawlforge.dev/",
        "snippet": "Search, scrape, crawl and extract from any site through one MCP server.",
        "displayLink": "www.crawlforge.dev",
        "formattedUrl": "https://www.crawlforge.dev/",
        "htmlSnippet": "Search, scrape, crawl and extract from any site through one MCP server.",
        "htmlTitle": "CrawlForge MCP Server — 29 web tools for Claude",
        "cacheId": "x8Kd0PqR2mUJ",
        "pagemap": {
          "metatags": [
            {
              "og:type": "website"
            }
          ]
        }
      }
    ],
    "spelling_correction": "mcp server for web scraping",
    "related_searches": [
      "mcp web scraping tools",
      "model context protocol scraper"
    ]
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 460
}

Field Descriptions

data.queryIstilah yang benar-benar dicari oleh Google, yang boleh berbeza daripada apa yang anda hantar

data.search_metadata.total_resultsAnggaran Google bagi dokumen yang sepadan. Satu anggaran, bukan kiraan yang boleh anda halusuri

data.search_metadata.results_returnedPanjang `results` — paling banyak 10

data.search_metadata.search_timeSaat yang digunakan Google, seperti yang dilaporkan oleh Google. Bukan kependaman permintaan anda

data.results[].urlPautan destinasi. `formattedUrl` ialah versi paparan Google bagi alamat yang sama

data.results[].htmlSnippetCebisan dengan penyorotan istilah `<b>` Google dikekalkan. Lepaskannya sebelum memaparkan

data.results[].cacheIdPengecam cache Google, apabila ia ada. Tiada bagi hasil yang tidak dicache oleh Google

data.results[].pagemapData berstruktur yang diangkat Google daripada halaman — tag meta, imej, jenis schema.org. Bentuknya berbeza bagi setiap hasil dan boleh jadi tiada

data.spelling_correctionEjaan yang dicadangkan Google, atau `null` apabila tiada

data.related_searchesCadangan pertanyaan berkaitan. Kerap kali merupakan tatasusunan kosong

credits_used5 credits tetap setiap carian, apa jua `limit` yang anda minta

Pengendalian Ralat

Pertanyaan Tidak Sah (400 Bad Request)

VALIDATION_ERROR. query diperlukan dan tidak boleh kosong. Status yang sama meliputi limit di luar 1-100, offset negatif, atau time_range yang bukan salah satu daripada lima nilai yang diterima.

Carian Gagal (500 Internal Server Error)

TOOL_ERROR. Merangkumi ralat Google di hulu, kuota harian yang habis, dan tamat masa selepas 10 saat. Mesejnya menyatakan puncanya. Carian yang gagal tidak dicaj.

Nota: Carian yang tidak sepadan dengan apa-apa mengembalikan 200 dengan tatasusunan results yang kosong dan total_results: 0 — bukan ralat. Periksa results_returned dan bukannya bergantung pada kod status.

Kos Credit

5 credits

5 credits setiap carian

Satu carian ialah satu caj, sama ada ia mengembalikan 10 hasil atau tiada. Berhalaman dengan offset bermakna satu lagi carian, jadi sepuluh halaman berharga 50 credits. Carian yang gagal tidak dicaj.

Apa yang Disertakan:

Indeks langsung Google, bukan salinan cache

Tajuk, URL, cebisan dan varian bersorot Google

Anggaran jumlah padanan dan masa carian

Penapis site, file_type, lang, time_range dan carian selamat

Pembetulan ejaan dan carian berkaitan apabila Google membekalkannya

Cadangan Pelan:

Free Plan: 1,000 credits percubaan sekali sahaja = 200 carian

Hobby Plan: 5,000 credits = 1,000 carian ($19/mo)

Professional Plan: 50,000 credits = 10,000 carian ($99/mo)

Alat Berkaitan

serp_rank

Kedudukan organik tepat satu domain bagi satu pertanyaan (5 credits)

reddit_search

Cari di Reddit, yang menyekat scraping secara terus (5 credits)

deep_research

Cari, baca dan sintesiskan dalam satu panggilan (10 credits)

batch_scrape

Kikis URL yang dikembalikan oleh sesuatu carian (5 credits setiap URL)

Bersedia untuk mencuba search_web? Daftar secara percuma dan dapatkan 1,000 credits untuk mula membina.