DataForSEO 搜尋

取得 API 存取權： DataForSEO

設定

1. 前往 DataForSEO 並建立帳號
2. 前往您的帳戶儀表板
3. 產生 API 憑證：
   • 您將收到 登入名稱（使用者名稱）
   • 您將收到 密碼
4. 設定您的環境變數：
   • DATAFORSEO_LOGIN - 您的 DataForSEO 登入名稱/使用者名稱
   • DATAFORSEO_PASSWORD - 您的 DataForSEO 密碼

LiteLLM Python SDK

DataForSEO Search

import os
from litellm import search

os.environ["DATAFORSEO_LOGIN"] = "your-login"
os.environ["DATAFORSEO_PASSWORD"] = "your-password"

response = search(
    query="latest AI developments",
    search_provider="dataforseo",
    max_results=10
)

LiteLLM AI Gateway

1. 設定 config.yaml

config.yaml

model_list:
  - model_name: gpt-5.6-terra
    litellm_params:
      model: gpt-5.6-terra
      api_key: os.environ/OPENAI_API_KEY

search_tools:
  - search_tool_name: dataforseo-search
    litellm_params:
      search_provider: dataforseo

Proxy 會從其環境中讀取 DATAFORSEO_LOGIN 和 DATAFORSEO_PASSWORD，因此不需要 api_key。若要明確傳遞認證，請將 api_key 設為單一 login:password 字串，可以是字面值，或來自單一環境變數，例如 api_key: os.environ/DATAFORSEO_API_KEY，其中 DATAFORSEO_API_KEY=your-login:your-password。以 : 串接的兩個 os.environ/ 參照不會被解析

2. 啟動 proxy

litellm --config /path/to/config.yaml

# RUNNING on http://0.0.0.0:4000

3. 測試搜尋端點

Test Request

curl http://0.0.0.0:4000/v1/search/dataforseo-search \
  -H "Authorization: Bearer $LITELLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest AI developments",
    "max_results": 10
  }'

供應者特定參數

DataForSEO Search with Provider-specific Parameters

import os
from litellm import search

os.environ["DATAFORSEO_LOGIN"] = "your-login"
os.environ["DATAFORSEO_PASSWORD"] = "your-password"

response = search(
    query="AI developments",
    search_provider="dataforseo",
    max_results=10,
    # DataForSEO-specific parameters
    country="United States",       # Country name for location_name
    language_code="en",            # Language code
    depth=20,                      # Number of results (max 700)
    device="desktop",              # Device type ('desktop', 'mobile', 'tablet')
    os="windows"                   # Operating system
)