Google 搜尋 API

用關鍵字查詢 Google 搜尋結果，回傳結構化 JSON（含標題、連結、摘要）。認證以 Authorization: Bearer YOUR_API_KEY 標頭帶開發者金鑰（也接受 X-Dev-Key 標頭），或已登入的網頁 session；金鑰不可放在網址查詢參數（會進入伺服器紀錄）。GET 呼叫，參數 q（關鍵字，string）必填；呼叫成功會自動扣點數，查詢失敗或查無結果不扣點。新聞報導請見 Google News API 分頁。

GET https://www.myai168.com/futaba/api/google/search

Google 搜尋，回傳網頁結果（每筆含 title／link／snippet，最多 20 筆）。

選填參數格式不符時會被自動忽略（不報錯）；後端固定組 Google 搜尋網址，無法帶入任意網址。

curl "https://www.myai168.com/futaba/api/google/search?q=Trump&hl=zh-TW&gl=tw" \
  -H "Authorization: Bearer YOUR_DEV_KEY"

import requests

r = requests.get(
    "https://www.myai168.com/futaba/api/google/search",
    headers={"Authorization": "Bearer YOUR_DEV_KEY"},
    params={"q": "Trump", "hl": "zh-TW", "gl": "tw"},
)
print(r.json())

回應格式

成功回 HTTP 200 JSON 物件：帶回生效的查詢參數（q／hl／gl／lr／cr／tbm／tbs，未生效者為空字串）、url（實際組出的 Google 搜尋網址）、count（筆數）、results（結果陣列，每筆含 title／link／snippet）、cost（本次扣點）與 credits（扣後餘額）；回應標頭另帶 X-Cost-Points（本次扣點）與 X-Credits-Remaining（扣後餘額）。

{
  "q": "Trump",
  "hl": "zh-TW",
  "gl": "tw",
  "url": "https://www.google.com/search?q=Trump&hl=zh-TW&gl=tw",
  "count": 10,
  "results": [
    {"title": "...", "link": "https://...", "snippet": "..."}
  ],
  "cost": 66,
  "credits": 12345
}

錯誤碼