此仓库是即将成为官方 Python API 封装的 SerpApi 的家。此 serpapi 模块允许您从 Python 应用程序访问搜索数据。

SerpApi 支持 Google、Google Maps、Google Shopping、Bing、Baidu、Yandex、Yahoo、eBay、应用商店等。查看文档以获取完整列表。

安装

要安装 serpapi 包，只需运行以下命令

$ pip install serpapi

请注意，此包与 PyPi 上可用的旧版 serpapi 模块分开，该模块的名称为 google-search-results。此包由 SerpApi 维护，并是从 Python 访问 SerpApi 服务的推荐方式。

用法

让我们从在 Google 上搜索咖啡开始

>>> import serpapi
>>> s = serpapi.search(q="Coffee", engine="google", location="Austin, Texas", hl="en", gl="us")

变量 s 现在包含一个 SerpResults 对象，该对象就像一个标准的字典，上面增加了一些方便的功能。

让我们打印第一个结果

>>> s["organic_results"][0]["link"]
'https://en.wikipedia.org/wiki/Coffee'

让我们以更 Pythonic 的方式打印第一个结果的标题

>>> s["organic_results"][0].get("title")
'Coffee - Wikipedia'

SerpApi.com API 文档 包含可以向 API 传递的所有可能参数的列表。

文档

文档可在 Read the Docs 上找到。

Python 基本示例

搜索 Bing

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'bing',
    'q': 'coffee',
})

• API 文档：serpapi.com/bing-search-api

搜索 Baidu

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'baidu',
    'q': 'coffee',
})

• API 文档：serpapi.com/baidu-search-api

搜索 Yahoo

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'yahoo',
    'p': 'coffee',
})

• API 文档：serpapi.com/yahoo-search-api

搜索 YouTube

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'youtube',
    'search_query': 'coffee',
})

• API 文档：serpapi.com/youtube-search-api

搜索 Walmart

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'walmart',
    'query': 'coffee',
})

• API 文档：serpapi.com/walmart-search-api

搜索 eBay

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'ebay',
    '_nkw': 'coffee',
})

• API 文档：serpapi.com/ebay-search-api

搜索 Naver

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'naver',
    'query': 'coffee',
})

• API 文档：serpapi.com/naver-search-api

搜索 Home Depot

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'home_depot',
    'q': 'table',
})

• API 文档：serpapi.com/home-depot-search-api

搜索 Apple App Store

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'apple_app_store',
    'term': 'coffee',
})

• API 文档：serpapi.com/apple-app-store

搜索 DuckDuckGo

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'duckduckgo',
    'q': 'coffee',
})

• API 文档：serpapi.com/duckduckgo-search-api

搜索 Google

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google',
    'q': 'coffee',
    'engine': 'google',
})

• API 文档：serpapi.com/search-api

搜索 Google Scholar

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_scholar',
    'q': 'coffee',
})

• API 文档：serpapi.com/google-scholar-api

搜索 Google 自动补全

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_autocomplete',
    'q': 'coffee',
})

• API 文档：serpapi.com/google-autocomplete-api

搜索 Google 产品

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_product',
    'q': 'coffee',
    'product_id': '4887235756540435899',
})

• API 文档：serpapi.com/google-product-api

搜索 Google 反向图片

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_reverse_image',
    'image_url': 'https://i.imgur.com/5bGzZi7.jpg',
    'max_results': '1',
})

• API 文档：serpapi.com/google-reverse-image

搜索 Google 活动

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_events',
    'q': 'coffee',
})

• API 文档：serpapi.com/google-events-api

搜索 Google 本地服务

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_local_services',
    'q': 'electrician',
    'data_cid': '6745062158417646970',
})

• API 文档：serpapi.com/google-local-services-api

搜索 Google 地图

import os
import serpapi


client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_maps',
    'q': 'pizza',
    'll': '@40.7455096,-74.0083012,15.1z',
    'type': 'search',
})

• API 文档：serpapi.com/google-maps-api

搜索 Google 招聘

import os
import serpapi


client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_jobs',
    'q': 'coffee',
})

• API 文档：serpapi.com/google-jobs-api

搜索 Google Play

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_play',
    'q': 'kite',
    'store': 'apps',
    'max_results': '2',
})

• API 文档：serpapi.com/google-play-api

搜索 Google 图片

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))
results = client.search({
    'engine': 'google_images',
    'tbm': 'isch',
    'q': 'coffee',
})

• API 文档：serpapi.com/images-results

许可证

MIT 许可证。

贡献

欢迎在GitHub上提交错误报告和拉取请求。一旦安装了依赖项，您可以使用pytest运行测试。