3 步實現 xAI Grok API 聯網搜索：x_search 和 web_search 完整指南

作者注：詳細介紹 xAI Grok API 的最新聯網搜索功能，包括 x_search 搜索 X 平臺內容和 web_search 網頁搜索的完整配置方法和代碼示例

很多開發者在使用 xAI Grok API 時都有一個疑問：Grok API 怎麼實現聯網搜索？ 以前 xAI 提供的 Live Search API 現已下線，現在官方推出了更強大的 Tools 工具調用功能，通過 x_search 和 web_search 兩個服務端工具實現聯網搜索能力。

核心價值: 讀完本文，你將掌握使用 xAI Grok API 進行 X 平臺內容搜索和網頁搜索的完整方法，讓你的 AI 應用獲取實時信息。

xAI Grok API 聯網搜索核心要點

xAI Grok API 聯網搜索重點詳解

Live Search API 廢棄時間表: xAI 官方已宣佈，原有的 Live Search API（通過 search_parameters 配置）將於 2026 年 1 月 12 日正式廢棄。屆時請求將返回 410 Gone 狀態碼。開發者需要儘快遷移到新的 Agent Tools API，以確保服務的連續性。

新架構的核心優勢: 新的 Tools 工具調用採用服務端自主執行模式。當你在請求中提供 x_search 或 web_search 工具時，xAI 服務器會自動編排一個智能推理循環——模型會自主分析問題、發起搜索、分析結果、必要時進行追加查詢，最終返回綜合性回答。這種 Agentic Search（智能體搜索）的方式比傳統的簡單搜索更加智能和全面。

xAI Grok API 聯網搜索快速上手

極簡示例

以下是使用 x_search 搜索 X 平臺內容的最簡示例：

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast"，
    "input": [
      {
        "role": "user"，
        "content": "What is the current status of xAI？"
      }
    ]，
    "tools": [
      {
        "type": "x_search"
      }
    ]
  }'

import requests
import os

def grok_x_search（query: str， allowed_handles: list = None） -> dict:
    """
    使用 xAI Grok API 的 x_search 工具搜索 X 平臺內容

    Args:
        query: 搜索查詢內容
        allowed_handles: 可選，限定搜索的 X 用戶列表（最多 10 個）

    Returns:
        API 響應結果
    """
    url = "https://api.x.ai/v1/responses"
    headers = {
        "Content-Type": "application/json"，
        "Authorization": f"Bearer {os.environ.get（'XAI_API_KEY'）}"
    }

    # 構建 x_search 工具配置
    x_search_tool = {"type": "x_search"}
    if allowed_handles:
        x_search_tool["allowed_x_handles"] = allowed_handles

    payload = {
        "model": "grok-4-1-fast"，
        "input": [
            {"role": "user"， "content": query}
        ]，
        "tools": [x_search_tool]
    }

    response = requests.post（url， headers=headers， json=payload）
    return response.json（）

# 使用示例：搜索特定用戶的推文
result = grok_x_search（
    query="What are the latest announcements about Grok？"，
    allowed_handles=["elonmusk"， "xaboratory"]
）
print（result）

建議: 如果你需要同時測試多種 AI 模型的聯網搜索能力，可以通過 API易 apiyi.com 獲取統一的 API 接口。平臺支持 xAI Grok、OpenAI、Claude 等主流模型，便於快速對比不同模型的搜索效果。

xAI Grok API x_search 工具詳解

x_search 是專門用於搜索 X（原 Twitter）平臺內容的工具，支持關鍵詞搜索、語義搜索、用戶搜索和話題抓取。

x_search 參數配置

x_search 使用示例

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast"，
    "input": [
      {
        "role": "user"，
        "content": "總結 Elon Musk 最近關於 AI 的觀點"
      }
    ]，
    "tools": [
      {
        "type": "x_search"，
        "allowed_x_handles": ["elonmusk"]，
        "from_date": "2025-12-01"，
        "to_date": "2026-01-23"
      }
    ]
  }'

使用技巧: 使用 allowed_x_handles 限定搜索範圍可以提高搜索結果的相關性和準確性，特別適合追蹤特定行業專家或官方賬號的動態。

xAI Grok API web_search 工具詳解

web_search 工具可以搜索整個互聯網並自動瀏覽網頁內容，是獲取實時網絡信息的強大工具。

web_search 參數配置

web_search 使用示例

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast"，
    "input": [
      {
        "role": "user"，
        "content": "What are the latest features of GPT-4o？"
      }
    ]，
    "tools": [
      {
        "type": "web_search"，
        "allowed_domains": ["openai.com"， "techcrunch.com"]
      }
    ]
  }'

場景建議: 當你需要獲取權威技術信息時，使用 allowed_domains 限定到官方文檔站點可以確保信息的準確性。

xAI Grok API 聯網搜索方案對比

對比說明: 兩種工具可以同時使用，xAI 服務器會根據問題性質自動選擇合適的工具進行搜索。通過 API易 apiyi.com 可以方便地測試不同搜索策略的效果。

xAI Grok API 聯網搜索引用和來源

使用聯網搜索後，API 會返回搜索過程中訪問的所有來源信息。有兩種引用模式：

引用返回格式

# 啓用內聯引用的請求示例
payload = {
    "model": "grok-4-1-fast"，
    "input": [{"role": "user"， "content": "xAI 公司的最新動態"}]，
    "tools": [{"type": "x_search"}， {"type": "web_search"}]，
    "inline_citations": True  # 啓用內聯引用
}

注意: 啓用內聯引用後，模型會根據上下文自主決定是否在回答中添加引用，並非每個回答都會包含內聯引用。

常見問題

總結

xAI Grok API 聯網搜索的核心要點：

1. 及時遷移: Live Search API 將於 2026 年 1 月 12 日廢棄，儘快遷移到 Tools 工具調用方式
2. 雙工具配合: x_search 適合社交媒體內容，web_search 適合全網信息，兩者可同時使用
3. 智能推理: 新架構採用 Agentic Search 模式，模型會自動進行多輪搜索和分析

xAI 的 Grok API 聯網搜索功能在獲取 X 平臺實時內容方面具有獨特優勢，特別適合需要追蹤社交媒體動態的應用場景。

推薦通過 API易 apiyi.com 快速驗證效果，平臺提供免費額度和多模型統一接口，方便對比 xAI Grok 與其他模型的聯網搜索能力。

📚 參考資料

⚠️ 鏈接格式說明: 所有外鏈使用 資料名: domain.com 格式，方便複製但不可點擊跳轉，避免 SEO 權重流失。

1. xAI Search Tools 官方文檔: 完整的搜索工具參數說明和示例

   • 鏈接: docs.x.ai/docs/guides/tools/search-tools
   • 說明: 官方權威文檔，包含最新的 API 規範

2. xAI Tools Overview: 工具調用系統總覽

   • 鏈接: docs.x.ai/docs/guides/tools/overview
   • 說明: 瞭解 xAI 服務端工具的整體架構

3. xAI Live Search 遷移指南: 廢棄公告和遷移說明

   • 鏈接: docs.x.ai/docs/guides/live-search
   • 說明: 瞭解廢棄時間表和遷移路徑

作者: 技術團隊
技術交流: 歡迎在評論區討論，更多資料可訪問 API易 apiyi.com 技術社區