google-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Google Search (SERP)

Search the web through AceDataCloud's Google SERP API.

Setup: See authentication for token setup.

通过AceDataCloud的Google SERP API进行网页搜索。

设置: 请查看身份验证了解令牌设置方法。

Quick Start

快速开始

bash

curl -X POST https://api.acedata.cloud/serp/google \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news", "type": "search"}'

bash

curl -X POST https://api.acedata.cloud/serp/google \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news", "type": "search"}'

Search Types

搜索类型

Type	Description	Returns
`search`	Web search (default)	Organic results, knowledge graph, rich snippets
`images`	Image search	Image URLs, titles, sources
`news`	News articles	Headlines, sources, publish dates
`maps`	Map results	Locations, coordinates
`places`	Local businesses/places	Name, address, rating, reviews
`videos`	Video results	Video URLs, thumbnails, duration

类型	描述	返回内容
`search`	网页搜索（默认）	自然搜索结果、知识图谱、富摘要
`images`	图片搜索	图片URL、标题、来源
`news`	新闻搜索	标题、来源、发布日期
`maps`	地图搜索结果	地点、坐标
`places`	本地商家/场所	名称、地址、评分、评论
`videos`	视频搜索结果	视频URL、缩略图、时长

Parameters

参数

json

POST /serp/google
{
  "query": "your search query",
  "type": "search",
  "country": "us",
  "language": "en",
  "range": "qdr:w",
  "number": 10,
  "page": 1
}

Parameter	Type	Description
`query`	string	Search query (required)
`type`	string	One of: search, images, news, maps, places, videos
`country`	string	Country code (e.g., "us", "uk", "cn", "jp")
`language`	string	Language code (e.g., "en", "zh", "ja")
`range`	string	Time filter (see below)
`number`	int	Number of results per page
`page`	int	Page number for pagination

json

POST /serp/google
{
  "query": "your search query",
  "type": "search",
  "country": "us",
  "language": "en",
  "range": "qdr:w",
  "number": 10,
  "page": 1
}

参数	类型	描述
`query`	string	搜索关键词（必填）
`type`	string	可选值：search、images、news、maps、places、videos
`country`	string	国家代码（例如："us"、"uk"、"cn"、"jp"）
`language`	string	语言代码（例如："en"、"zh"、"ja"）
`range`	string	时间筛选器（详见下文）
`number`	int	每页结果数量
`page`	int	分页页码

Time Range Options

时间范围选项

Value	Period
`qdr:h`	Past hour
`qdr:d`	Past 24 hours
`qdr:w`	Past week
`qdr:m`	Past month
`qdr:y`	Past year

值	时间段
`qdr:h`	过去1小时
`qdr:d`	过去24小时
`qdr:w`	过去一周
`qdr:m`	过去一个月
`qdr:y`	过去一年

Response Structure

响应结构

Web search returns structured data including:

```
organic_results
```
: Main search results with title, link, snippet
```
knowledge_graph
```
: Entity information panel (when available)
```
related_searches
```
: Related query suggestions

网页搜索返回的结构化数据包括：

```
organic_results
```
: 包含标题、链接、摘要的主要搜索结果
```
knowledge_graph
```
: 实体信息面板（如有）
```
related_searches
```
: 相关搜索建议

Gotchas

注意事项

Default search type is
```
"search"
```
(web). Always specify
```
type
```
for non-web searches
Country and language codes affect result localization significantly
```
number
```
controls results per page, not total results — use
```
page
```
for pagination
Time range (
```
range
```
) only applies to web search and news, not images or places
Image search returns thumbnail and full-size URLs — use full-size for downloads
Places search works best with location-specific queries (e.g., "restaurants near Times Square")

MCP:
pip install mcp-serp
| Hosted:
https://serp.mcp.acedata.cloud/mcp
| See all MCP servers

默认搜索类型为
```
"search"
```
（网页搜索）。非网页搜索请务必指定
```
type
```
参数
国家和语言代码会显著影响结果的本地化
```
number
```
控制每页结果数量，而非总结果数——使用
```
page
```
参数进行分页
时间范围（
```
range
```
）仅适用于网页搜索和新闻搜索，不适用于图片或场所搜索
图片搜索返回缩略图和全尺寸URL——下载请使用全尺寸URL
场所搜索结合地点相关关键词效果最佳（例如："Times Square附近的餐厅"）

MCP:
pip install mcp-serp
| 托管地址:
https://serp.mcp.acedata.cloud/mcp
| 查看所有MCP服务器