google-search

Original：🇺🇸 English

Translated

Search the web using Google via AceDataCloud API. Use when searching for web pages, images, news, maps, local places, or videos. Supports localization, time filtering, and pagination. Returns structured results with titles, snippets, URLs, and rich data.

12installs

Sourceacedatacloud/skills

Added on2026-07-04

NPX Install

npx skill4agent add acedatacloud/skills google-search

SKILL.md Content

View Translation Comparison →

Google Search (SERP)

Search the web through AceDataCloud's Google SERP API.

Setup: See authentication for token setup.

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"}'

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

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

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

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

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