Google Search (SERP)
Search the web through AceDataCloud's Google SERP API.
Authentication
export ACEDATACLOUD_API_TOKEN="your-token-here"
Quick Start
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", "search_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
POST /serp/google
{
"query": "your search query",
"search_type": "search",
"country": "us",
"language": "en",
"time_range": "qdr:w",
"number": 10,
"page": 1
}
| Parameter |
Type |
Description |
query |
string |
Search query (required) |
search_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") |
time_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, snippetknowledge_graph: Entity information panel (when available)related_searches: Related query suggestions
MCP Server
pip install mcp-serp
Or hosted: https://serp.mcp.acedata.cloud/mcp
Key tool: serp_google_search
Gotchas
- Default search type is
"search" (web). Always specify search_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 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")
1---2name: google-search3description: 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.4license: Apache-2.05---67# Google Search (SERP)89Search the web through AceDataCloud's Google SERP API.1011## Authentication1213```bash14export ACEDATACLOUD_API_TOKEN="your-token-here"15```1617## Quick Start1819```bash20curl -X POST https://api.acedata.cloud/serp/google \21 -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \22 -H "Content-Type: application/json" \23 -d '{"query": "latest AI news", "search_type": "search"}'24```2526## Search Types2728| Type | Description | Returns |29|------|-------------|---------|30| `search` | Web search (default) | Organic results, knowledge graph, rich snippets |31| `images` | Image search | Image URLs, titles, sources |32| `news` | News articles | Headlines, sources, publish dates |33| `maps` | Map results | Locations, coordinates |34| `places` | Local businesses/places | Name, address, rating, reviews |35| `videos` | Video results | Video URLs, thumbnails, duration |3637## Parameters3839```json40POST /serp/google41{42 "query": "your search query",43 "search_type": "search",44 "country": "us",45 "language": "en",46 "time_range": "qdr:w",47 "number": 10,48 "page": 149}50```5152| Parameter | Type | Description |53|-----------|------|-------------|54| `query` | string | Search query (required) |55| `search_type` | string | One of: search, images, news, maps, places, videos |56| `country` | string | Country code (e.g., "us", "uk", "cn", "jp") |57| `language` | string | Language code (e.g., "en", "zh", "ja") |58| `time_range` | string | Time filter (see below) |59| `number` | int | Number of results per page |60| `page` | int | Page number for pagination |6162## Time Range Options6364| Value | Period |65|-------|--------|66| `qdr:h` | Past hour |67| `qdr:d` | Past 24 hours |68| `qdr:w` | Past week |69| `qdr:m` | Past month |70| `qdr:y` | Past year |7172## Response Structure7374Web search returns structured data including:75- `organic_results`: Main search results with title, link, snippet76- `knowledge_graph`: Entity information panel (when available)77- `related_searches`: Related query suggestions7879## MCP Server8081```bash82pip install mcp-serp83```8485Or hosted: `https://serp.mcp.acedata.cloud/mcp`8687Key tool: `serp_google_search`8889## Gotchas9091- Default search type is `"search"` (web). Always specify `search_type` for non-web searches92- Country and language codes affect result localization significantly93- `number` controls results per page, not total results — use `page` for pagination94- Time range only applies to web search and news, not images or places95- Image search returns thumbnail and full-size URLs — use full-size for downloads96- Places search works best with location-specific queries (e.g., "restaurants near Times Square")
luokai0