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, 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 resolution (important for video / full-screen use): results include image_url (full-size), thumbnail_url, and image_width/image_height. Pass image_size: "large" (or a megapixel minimum like "4mp") to get sharp sources, and pick the result with the largest image_width×image_height. Always download image_url — never use thumbnail_url as 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

google-search

Google Search (SERP)

Quick Start

Search Types

Parameters

Time Range Options

Response Structure

Gotchas