Google Search (SERP)
Search the web through AceDataCloud's Google SERP API.
Setup: See authentication for token setup.
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", "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",
"type": "search",
"country": "us",
"language": "en",
"range": "qdr:w",
"number": 10,
"page": 1
}
| Parameter | Type | Description |
|---|---|---|
query | string | Search query (required; must contain non-whitespace text; maximum 2048 characters) |
type | string | One of: search, images, news, maps, places, videos |
country | string | Non-empty country code (e.g., "us", "uk", "cn", "jp"; maximum 32 characters) |
language | string | Non-empty language code (e.g., "en", "zh", "ja"; maximum 32 characters) |
range | string | Time filter (see below) |
number | int | Number of results per page |
page | int | Page number for pagination |
image_size | string | Images only. Filter by size for high-res sources: large / medium / icon, or a megapixel minimum 2mp…70mp (e.g. 4mp = larger than 4 megapixels). Use large (or a *mp value) whenever the image will be shown large / full-screen / zoomed. |
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 |
h | Past hour |
d | Past 24 hours |
w | Past week |
m | Past month |
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
Gotchas
- Default search type is
"search"(web). Always specifytypefor non-web searches - Country and language codes affect result localization significantly
numbercontrols results per page, not total results — usepagefor pagination- Time range (
range) only applies to web search and news, not images or places - Image resolution (important for video / full-screen use): results include
image_url(full-size),thumbnail_url, andimage_width/image_height. Passimage_size: "large"(or a megapixel minimum like"4mp") to get sharp sources, and pick the result with the largestimage_width×image_height. Always downloadimage_url— never usethumbnail_urlas a final asset (it is tiny and blurry). - 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