跳转到内容
serp.cheap

Python SDK

serpcheap 是官方的 Python 客户端 —— Python 3.8+，仅标准库。

安装

Section titled “安装”
Terminal window
pip install serpcheap

快速开始

Section titled “快速开始”
from serpcheap import SerpCheap


client = SerpCheap("YOUR_API_KEY")
res = client.search(q="best running shoes", gl="us")
print(res.organic[0].title)

参数

Section titled “参数”
res = client.search(
    q="best running shoes",  # required
    gl="us",                 # country (default "us")
    hl="en",                 # UI language (optional)
    tbs="qdr:d",             # time filter: qdr:h / qdr:d / qdr:w
    page=1,                  # 1-indexed (default 1)
)

响应字段：res.search、res.page、res.organic、res.ads、res.knowledge_graph、 res.people_also_ask、res.related_searches、res.stats（balance、cost、cached）。

选项与分页

Section titled “选项与分页”
client = SerpCheap("YOUR_API_KEY", timeout_ms=15000, max_retries=2)


for page in client.search_pages(q="coffee makers", from_=1, to=5):
    for result in page.organic:
        print(result.position, result.title)

错误处理

Section titled “错误处理”
from serpcheap import SerpCheapError


try:
    res = client.search(q="query")
except SerpCheapError as e:
    print(e.code, e.status, e.retry_after_ms, e.retryable)